Skip to main content
POST
Send a LinkedIn message to a lead using their ID. The lead’s LinkedIn URL is looked up automatically from the database. Supports template variables like {{firstName}} and {{lastName}}.

Request

string
required
Your API key
string
required
The lead ID to send the message to
string
required
The LinkedIn sender account ID to use. Get available senders from the List Senders endpoint.
string
required
The message content to send (max 8000 characters). Supports template variables:
  • {{firstName}} - Lead’s first name
  • {{lastName}} - Lead’s last name

Response

boolean
Whether the message was sent successfully
string
Unique identifier for the sent message
string
The LinkedIn URL of the lead
string
The lead ID the message was sent to
string
Message status: sent
string
ISO 8601 timestamp when the message was sent
The lead must be a 1st-degree connection of the sender. Attempting to message a non-connected lead will result in an error.
Use template variables like {{firstName}} to personalize your messages. The variables are automatically replaced with the lead’s actual data.

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

leadId
string
required

The lead ID to send the message to

Body

application/json
senderId
string
required

The LinkedIn sender account ID to use

message
string
required

The message content to send. Supports template variables: {{firstName}} (lead's first name), {{lastName}} (lead's last name).

Maximum string length: 8000

Response

Message sent successfully

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