Skip to main content
POST
Create a new chat

Authorizations

Authorization
string
header
required

Bearer token authentication. Include your API token in the Authorization header.

Format: Authorization: Bearer <your-token>

Headers

Idempotency-Key
string

Optional 1–255 character key for safe retries. If message.idempotency_key is also present, the two values must match.

Required string length: 1 - 255

Body

application/json
from
string
required

Authenticated sender's Relay Handle.

to
string[]
required
Required array length: 1 - 31 elements
message
object
required

Initial message for the new chat.

First outbound message link restriction: The initial message cannot be a link. A request is rejected with 400 (error code 1005) if it includes a link part or any text part containing a URL. Follow-up messages via POST /v1/chats/{chatId}/messages may contain links.

Response

Chat created successfully

Response for creating a new chat with an initial message

chat
object
required