Skip to main content
The Send Message endpoint creates an async task to send a LinkedIn direct message to a connection. You provide the recipient’s person URN and the message text; the API handles delivery through your team’s oldest admin member’s LinkedIn account.

Endpoint

Request Body

string
required
The LinkedIn person URN of the message recipient (e.g., "urn:li:person:ACoAABCDEFG")
string
required
The message text to send. Maximum 10,000 characters. Must not be empty or whitespace-only.
Don’t have a recipient URN? Use the Fetch Profile endpoint to look up a profile by slug, the response includes a profile_urn field you can use here. You can also get URNs from the Search Profiles endpoint.
The message is sent from your team’s oldest admin member’s LinkedIn account. You can only send messages to people who are 1st-degree connections of that account. Make sure this team member has an active Chrome extension session.

Response

The endpoint returns immediately with a task ID:
boolean
Whether the task was created successfully
string
UUID to poll for results via Get Task Status
string
Human-readable confirmation

Polling for Results

Poll the Get Task Status endpoint to confirm the message was sent:

Completed Response

Code Examples

Error Responses

FAQ

The message is sent from your team’s oldest admin member’s LinkedIn account (sorted by when they joined the team). This is the team member whose Chrome extension session executes the action. Make sure this team member is aware that messages will be sent from their account via the API.
LinkedIn messaging via the API works the same as manual messaging, you can only send direct messages to 1st-degree connections of the account sending the message. Attempting to message a non-connection will result in a task failure.
The recipient_urn is a LinkedIn person URN in the format urn:li:person:XXXXXXXXXXX. You can obtain it from the profile_urn field in the Fetch Profile response, or from the results of the Search Profiles endpoint.
OutX does not rate-limit these requests for you. Each message is executed as a real LinkedIn message send. Sending many messages in quick succession can trigger LinkedIn’s spam detection. Space out messages by at least 30–60 seconds and avoid sending the same message to many people in a short time window. See Rate Limits for safe usage guidelines.
Yes, messages are capped at 10,000 characters. Requests with messages exceeding this limit will return a 400 error.

Learn More