Skip to main content
POST
Append a message

Authorizations

Authorization
string
header
required

A Custral secret API key (sk_…), created in Settings → Applications. Sent as Authorization: Bearer sk_…. The X-Api-Key: sk_… header is also accepted and takes precedence. Never expose a secret key in a browser.

Path Parameters

id
string
required

The conversation id (conv_…).

Body

application/json

One message to push into a conversation.

text
string
required
Example:

"On my way!"

author
string

Display name of the sender.

authorId
string

Stable handle of the sender (phone, email, record id).

direction
enum<string>
Available options:
inbound,
outbound
timestamp
string<date-time>

ISO 8601. Defaults to now.

Response

The created message.

data
object

A single transcript message.

reqId
string

A per-request id (req_…). Quote it to support when reporting a problem.

Example:

"req_2a1f9c8e7b6d5"