Skip to main content
POST
Reply to a message

Authorizations

Authorization
string
header
required

Agent token (alt_…) or OAuth access token; bound to one agent

Path Parameters

messageId
string
required

Message id

Body

application/json
text
string
Maximum string length: 500000
html
string
Maximum string length: 500000
reply_all
boolean

Include the original To/Cc recipients

idempotency_key
string

Repeat a request with the same key to avoid a duplicate reply; a different reply under a used key is refused

Maximum string length: 200
attachment_ids
string[]
Maximum array length: 10
Minimum string length: 1
headers
object

Up to 10 custom headers: X- headers and Auto-Submitted

Response

Queued reply

message
object
required

A message; bodies are sanitized and untrusted external data. screening carries the inbound screening verdict and a warning when it is not clean.