Documentation

Send message

POST/v1/conversations/:id/messages

Auth: Site public key (rk_pk_)

Send a visitor message. Supports optional file attachments via attachmentIds.

Path parameters

NameTypeDescription
idrequireduuidConversation ID

Body parameters

NameTypeDescription
idrequireduuidClient-generated message UUID
bodyrequiredstringMessage text
sitePublicKeyrequiredstringrk_pk_… key
attachmentIdsuuid[]Attachment IDs from uploads/sign

Responses

201Created message
{
  "id": "880e8400-e29b-41d4-a716-446655440003",
  "conversationId": "550e8400-e29b-41d4-a716-446655440000",
  "body": "Hi, I need help with my order",
  "senderType": "visitor",
  "createdAt": "2026-01-15T10:01:00Z"
}