Skip to main content
POST
Send LinkedIn connection request
Requires inbox:send. Supply senderId and recipientLinkedinUrl. The optional note field is message, at most 300 characters; MCP calls the corresponding argument note. Sender account capability and daily connection limits still apply. Use an Idempotency-Key and inspect uncertain outcomes before retrying. A successful REST request executes directly, without an MCP confirmation token.

Authorizations

X-API-Key
string
header
required

API key for authentication (prefix: sp_live_ or sp_test_)

Body

application/json
senderId
string
required

LinkedIn sender ID to use (must be connected to workspace)

Example:

"sender_123"

recipientLinkedinUrl
string
required

LinkedIn URL of the recipient to connect with

Example:

"https://www.linkedin.com/in/johndoe/"

message
string

Optional connection note (only works for premium LinkedIn accounts)

Maximum string length: 300
Example:

"Hi John, I would love to connect with you!"

Response

Connection request sent

success
boolean
required

Success status

Example:

true

requestId
string
required

Request ID

Example:

"conn_123"

recipientLinkedinUrl
string
required

Recipient LinkedIn URL

status
enum<string>
required

Connection status

Available options:
sent,
already_connected,
failed
Example:

"sent"

timestamp
string<date-time>
required

Timestamp when request was sent

error
string

Error message if failed