Skip to main content
POST
/
v1
/
inbox
/
connect
curl -X POST https://api.sendpilot.ai/v1/inbox/connect \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "senderId": "sender_abc123",
    "recipientLinkedinUrl": "https://www.linkedin.com/in/john-doe",
    "message": "Hi John, I came across your profile and would love to connect!"
  }'

{
  "success": true,
  "requestId": "conn_xyz789",
  "recipientLinkedinUrl": "https://www.linkedin.com/in/john-doe",
  "status": "sent",
  "timestamp": "2024-02-24T15:30:00.000Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.sendpilot.ai/llms.txt

Use this file to discover all available pages before exploring further.

Send a connection request to a LinkedIn profile. Optionally include a connection note (only works for premium LinkedIn accounts).

​
Request

​
X-API-Key
string
required
Your API key
​
senderId
string
required
The LinkedIn sender account ID to use. Get available senders from the List Senders endpoint.
​
recipientLinkedinUrl
string
required
The LinkedIn profile URL of the person to connect with (e.g., https://www.linkedin.com/in/john-doe)
​
message
string
Optional connection note (max 300 characters). Note: Connection notes only work for premium LinkedIn accounts.

​
Response

​
success
boolean
Whether the connection request was sent successfully
​
requestId
string
Unique identifier for the connection request
​
recipientLinkedinUrl
string
The LinkedIn URL of the recipient
​
status
string
Request status: sent or already_connected
​
timestamp
string
ISO 8601 timestamp when the request was sent
curl -X POST https://api.sendpilot.ai/v1/inbox/connect \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "senderId": "sender_abc123",
    "recipientLinkedinUrl": "https://www.linkedin.com/in/john-doe",
    "message": "Hi John, I came across your profile and would love to connect!"
  }'

{
  "success": true,
  "requestId": "conn_xyz789",
  "recipientLinkedinUrl": "https://www.linkedin.com/in/john-doe",
  "status": "sent",
  "timestamp": "2024-02-24T15:30:00.000Z"
}
When a connection request is sent, a connection.sent webhook event will be triggered. When the connection is accepted, a connection.accepted webhook event will be triggered.
Connection notes are only supported for LinkedIn Premium accounts. For free accounts, the connection request will be sent without a note.
LinkedIn has daily limits on connection requests. Check the sender’s remaining capacity using the List Senders endpoint.

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Body

application/json
​
senderId
string
required

The LinkedIn sender account ID to use

​
recipientLinkedinUrl
string
required

The LinkedIn profile URL of the person to connect with

​
message
string

Optional connection note. Only works for premium LinkedIn accounts.

Maximum string length: 300

Response

Connection request sent (or already connected)

​
success
boolean
required
​
requestId
string
required

Unique identifier for the connection request

​
recipientLinkedinUrl
string
required
​
status
enum<string>
required
Available options:
sent,
already_connected
​
timestamp
string<date-time>
required