Send a LinkedIn message

Send exact text to one LinkedIn profile and get a receipt that LinkedIn accepted it.

message.send · $0.01 per completed request

When to use it

Sends a message right away, as a reply or a new chat.

Request

Field	Type	Notes
`text`	string required	Unchanged final text. Reject blank/outer whitespace and C0/DEL controls other than internal LF/tab. Emoji and internal line breaks are preserved.
`target`	object required
`target.profileUrl`	string required	LinkedIn member profile URL, validated/canonicalized with the existing profile URL rules. Conversation URLs are not accepted for sending.

HTTP, against the local API:

POST http://127.0.0.1:3447/v1/operations/message.send
Authorization: Bearer <local-token>
Content-Type: application/json

{
  "text": "Thanks for the intro. Free on Thursday at 3?",
  "target": {
    "profileUrl": "https://www.linkedin.com/in/example-member/"
  }
}

The same request through the CLI, which adds the local token for you:

relay message send message.json   # message.json holds the JSON body above

Response

The result has operation, account, data, source and completeness. See Results. Fields in data:

Field	Type	Notes
`status`	"accepted" required
`recipient`	object required
`recipient.profileUrl`	string required
`recipient.profileUrn`	string required	Exact native recipient host identity, without namespace conversion.
`recipient.participantUrn`	string required	Recipient participant identity from the verified conversation.
`conversationUrl`	string required	Source-supplied conversation URL used for message read-back.
`conversationUrn`	string required
`messageUrn`	string required	New response-correlated message identity verified in the conversation source.
`senderUrn`	string required
`actorUrn`	string required
`text`	string required	Exact input text, verified against the accepted source message.
`deliveredAt`	number \| null required	Raw finite provider timestamp or null with a missing field.

For the exact contract, run relay schema.

Price

$0.01 per completed request. No subscription. Known failures are not charged. The $5 welcome credit covers 500 requests.

Onboard your agent

Other operations

Get a LinkedIn profile · Get a LinkedIn company · List people at a LinkedIn company · Search LinkedIn people · Search LinkedIn companies · List your LinkedIn connections · List LinkedIn invitations · List LinkedIn conversations · Read a LinkedIn conversation · List LinkedIn posts by a member or company · Get a LinkedIn post · List comments on a LinkedIn post · List reactions on a LinkedIn post · Read your LinkedIn feed · List LinkedIn notifications