Write

Send LinkedIn Message

Send a LinkedIn message to an existing conversation using its chat_id, or start a brand new conversation using the recipient's provider_id. Supports text up to 8000 characters, file and image attachments, and native voice notes up to 5MB that render as a playable waveform in the recipient's inbox. A built-in safety limit of 150 per day protects your account, and you can attribute the action to a campaign. Fails if neither chat_id nor provider_id is supplied.

send_messagePOST/api/v1/inbox/conversations/{chat_id}/messages
crispy — bash

Example prompt: Reply to chat msg_abc123 and let Jane know I'll send the deck over by end of day

{
  "chat_id": "msg_abc123",
  "message_id": "m_1042",
  "sent": true
}
Permission scope
core
Access
Write
Daily limit
150/day
Category
Messaging

What you can build

Reply to an active thread or open a fresh conversation with a new prospect
Send a personalized voice note that stands out in a crowded inbox
Attach a deck, image, or file directly inside a LinkedIn message
Track outbound messages against a specific campaign for clean reporting

Parameters

Inputs accepted by send_message.

NameTypeDescription
chat_idstringThe chat/conversation ID to send the message to. Get from list_conversations output.
provider_idstringLinkedIn provider_id of the recipient. Provide this OR chat_id to start a new conversation.
textstringThe message text to send (max 8000 chars). Optional when voice_note_url is provided.
voice_note_urlstringPublic URL of an audio file to send as a native LinkedIn voice note (.m4a, .mp3, .ogg, .wav, max 5MB). When provided, text is optional. The audio renders as a playable waveform in the recipient's inbox, not a file download.
attachmentsobject[]Images or files to attach (max 10MB each; .mp4 video files are capped at 5MB)
campaign_idstringCampaign slug (from list_campaigns) to track this action under.

The complete LinkedIn API. Ready when you are.

Connect your first LinkedIn profile in under 5 minutes. Every tool, every seat, no feature gates. Safe limits, warm-up, and full permission control built in.