Messages

Send a LinkedIn direct message to a 1st-degree lead, starting the conversation if none exists

Single-call, idempotent. The lead must belong to this workspace and be a 1st-degree connection of the sending account (this route can never cold-DM). Looks up any existing chat with that lead before creating one, so it is also safe to call when a conversation already exists. Draws from the SAME per-account daily message budget the outreach worker and MCP sendMessage use. Emits message.sent with details.source = "api". Use POST /api/v1/replies instead once you already have a chat_id and are continuing that thread.

post/api/v1/messages

Request

  • Base URL: https://app.reachium.io
  • URL: https://app.reachium.io/api/v1/messages
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Required. Caller-generated key. Retrying the SAME chat_id+text under the same key replays the original 201 response instead of sending again. An unresolved/ambiguous attempt remains 409 under that key; reconcile the external state before choosing a new key. Reusing the key with a DIFFERENT body returns 422 idempotency_key_reuse.

Request body

lead_idstring uuid

Exactly one of lead_id or linkedin_url.

linkedin_urlstring

A LinkedIn profile URL (https://www.linkedin.com/in/...). Exactly one of lead_id or linkedin_url.

linkedin_account_idstring uuid

Which of this workspace’s LinkedIn accounts sends. Required when more than one account could plausibly send (ambiguous_sender otherwise).

textstring required

Response

Sent.

errorunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.