Skip to main content
POST
/
v1
/
inbox
/
send
curl -X POST https://api.sendpilot.ai/v1/inbox/send \
  -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! Thanks for connecting. I wanted to follow up on our conversation about..."
  }'

{
  "success": true,
  "messageId": "msg_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 LinkedIn message directly to a recipient. The recipient must be a 1st-degree connection of the sender (connection must already be accepted).

​
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 recipient (e.g., https://www.linkedin.com/in/john-doe)
​
message
string
required
The message content to send (max 8000 characters)

​
Response

​
success
boolean
Whether the message was sent successfully
​
messageId
string
Unique identifier for the sent message
​
recipientLinkedinUrl
string
The LinkedIn URL of the recipient
​
status
string
Message status: sent
​
timestamp
string
ISO 8601 timestamp when the message was sent
curl -X POST https://api.sendpilot.ai/v1/inbox/send \
  -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! Thanks for connecting. I wanted to follow up on our conversation about..."
  }'

{
  "success": true,
  "messageId": "msg_xyz789",
  "recipientLinkedinUrl": "https://www.linkedin.com/in/john-doe",
  "status": "sent",
  "timestamp": "2024-02-24T15:30:00.000Z"
}
Messages can only be sent to recipients who are 1st-degree connections of the sender. Attempting to message a non-connected profile will result in an error.
When a message is sent, a message.sent webhook event will be triggered if you have webhooks configured.
To send a message to a lead by their ID (with automatic LinkedIn URL lookup), use the Send Message to Lead endpoint instead.

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Body

application/json
​
senderId
string
required

LinkedIn sender account ID to use

​
recipientLinkedinUrl
string
required

LinkedIn profile URL of the recipient

​
message
string
required

Message content (max 8000 characters)

Maximum string length: 8000
​
campaignId
string

Optional campaign ID for tracking

​
leadId
string

Optional lead ID for tracking

Response

Message sent successfully

​
success
boolean
required
​
messageId
string
required
​
recipientLinkedinUrl
string
required
​
status
enum<string>
required
Available options:
queued,
sent
​
timestamp
string<date-time>
required
​
leadId
string