Send Message / Private Note

POST

/v1/conversations/:conversation_id/messages

Sends a reply to the customer through the active channel (Email, WhatsApp, Chat, etc.) or records a private internal note for teammates.

Parameters

NameTypeDescription
conversation_idrequiredstringConversation UUID
contentstringMessage text or HTML (max 50,000 chars)
privatebooleanTrue for internal private notes (not sent to customer)
attachment_idsarray[string]Array of uploaded attachment UUIDs to attach

Responses

200Message created
{
  "data": {
    "id": "msg_003",
    "content": "Hello Alice! I have reviewed your invoice and refunded the difference.",
    "visibility": "global",
    "sender": {
      "id": "usr_888",
      "name": "Sarah Connor"
    },
    "created_at": "2026-09-02T13:05:00Z"
  }
}