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.
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
Whose LinkedIn account sends the message?
Whose LinkedIn account sends the message?
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.
Can I message anyone or only connections?
Can I message anyone or only connections?
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.
Where do I get the recipient_urn?
Where do I get the recipient_urn?
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.What about rate limits and LinkedIn safety?
What about rate limits and LinkedIn safety?
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.
Is there a message length limit?
Is there a message length limit?
Yes, messages are capped at 10,000 characters. Requests with messages exceeding this limit will return a
400 error.Related
- Get Task Status - Poll for task results
- Fetch Profile - Get a profile URN to use as
recipient_urn - Search Profiles - Find profiles and get their URNs
- Like Post - Like posts alongside messaging

