Send a message (messaging wrapper)
Send a LinkedIn message using the messaging endpoint. Wrapper around the core messaging functionality with a cleaner interface. Supports regular messages and InMail. Rate limit: 150 messages per day per account.
/messaging/sendCode Examples
curl -X POST 'https://api.connectsafely.ai/linkedin/messaging/send' \ -H 'Authorization: Bearer <your_api_key>' \ -H 'Content-Type: application/json' \ -d '{"accountId":"acc_12345","recipientProfileId":"john-doe-123","message":"Hello! I would like to connect with you.","subject":"Quick question about your work","messageType":"normal"}'Parameters
No parameters.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
accountId | string | No | LinkedIn account ID to use. If not provided, uses the default account. |
recipientProfileId | string | Conditional | Recipient LinkedIn profile public ID Either recipientProfileId or recipientProfileUrn must be provided. |
recipientProfileUrn | string | Conditional | Recipient LinkedIn profile URN Either recipientProfileUrn or recipientProfileId must be provided. |
message | string | Yes | Message content to send |
subject | string | No | Subject line (required for InMail) |
messageType | string | No | Message type |
Example
{
"recipientProfileUrn": "urn:li:fsd_profile:ACoAAFpqSoMB8vTqRbg4mN_wbabO8w0gjgFu-6o",
"message": "Hello, I would like to connect with you!"
}Responses
| Status | Description |
|---|---|
| 200 | Message sent successfully |
| 400 | Bad request - Missing required parameter |
| 401 | Unauthorized - Invalid or missing API key |
| 429 | Rate limit exceeded |
| 500 | Server error |
Rate Limit Headers
All responses include rate limit information in the headers:
| Header | Description |
|---|---|
X-RateLimit-Action | The action type being rate limited |
X-RateLimit-Limit | Maximum actions allowed per period |
X-RateLimit-Used | Actions used in current period |
X-RateLimit-Remaining | Actions remaining |
X-RateLimit-Reset | ISO 8601 timestamp when limit resets |
200 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
message | string | |
recipientProfileUrn | string |
200 Example
{
"success": true,
"message": "Message sent successfully",
"recipientProfileUrn": "urn:li:fsd_profile:ACoAAFpqSoMB8vTqRbg4mN_wbabO8w0gjgFu-6o"
}400 Response Parameters
| Name | Type | Description |
|---|---|---|
success | boolean | |
error | object |
400 Example
{
"success": false,
"error": "message is required"
}401 Example
{
"error": "Unauthorized - Invalid credentials"
}429 Response Parameters
| Name | Type | Description |
|---|---|---|
error | string | |
success | boolean |
429 Example
{
"error": "Rate limit exceeded for MESSAGE: 150/150 used. Resets at 2024-01-02T00:00:00.000Z",
"success": false
}500 Example
{
"error": "Failed to get LinkedIn authentication credentials",
"success": false
}Send typing indicator
Send a typing indicator to a LinkedIn conversation. Shows the recipient that you are typing a message. Useful for creating a more natural conversation experience before sending a message.
Send message with typing indicator
Send a LinkedIn message after showing a typing indicator first. Creates a more natural conversation experience by simulating human-like behavior. Requires conversationUrn for existing conversations. Rate limit: 150 messages per day per account.