Skip to main content
post/messages

Send a message

LLM
View as Markdown
Open llms.txt

Starts or continues a customer conversation by recipient. Choose an inbox first with `GET /inboxes`, optionally prepare WhatsApp template or media content, then send with a recipient that points to an existing conversation, a known contact, or a channel recipient. The response uses `202 Accepted`; poll `GET /messages/{id}` or the conversation messages endpoint to follow delivery state without webhooks.

Authorization

Scheme

  • bearerAuth

Allowed roles

  • owner
  • admin
  • agent

Send an outbound message. Conversation and channel recipients require message:create in conversation scope; contact recipients also resolve through contact:read.

Request body

  • Name
    application/json
    Type
    CreateMessageRequest
    Description
    Required body.

Responses

  • 202

    Message accepted for delivery

    • application/json SendMessageResponse
  • default

    Error

    • application/json ProblemDetails