Skip to main content
POST
Send a message

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
inbox_id
string
required
to
string[]
required
subject
string
required
cc
string[]
bcc
string[]
text
string
html
string
in_reply_to
string
references
string[]
client_id
string

Optional retry key, 1-255 UTF-8 bytes. A key binds the effective request content within this tenant. Retry with the same key and identical content; a different body or unresolved send returns 409. Never switch to a new key to retry an uncertain send. Omit it only when duplicate suppression is not needed.

attachments
object[]

Response

Sent

id
string
thread_id
string
message_id
string
ses_message_id
string
idempotent
boolean
reconciliation_required
boolean

When true, the persisted message proves provider acceptance, but attachment/storage completion or local acknowledgement still needs operator reconciliation. Do not send it again.