Post messagesemail
Authorizations
JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer
Body
Request body for sending an email through an agent
ID of the agent sending the email
^[0-9A-HJKMNP-TV-Z]{26}$List of recipient email addresses (at least one required)
1Email subject line (max 998 characters per RFC 2822)
1 - 998Plain-text body of the email
1Optional EmailIdentity ID to send from. Must belong to this agent and be verified. If omitted, the agent's primary identity is used. Use this to route different message types through different identities (e.g. transactional from @brawz.ai, support from @support.brawz.ai). List the agent's identities first via agent_email_identity_list to discover available IDs.
^[0-9A-HJKMNP-TV-Z]{26}$List of CC recipient email addresses
List of BCC recipient email addresses
Optional HTML body of the email
Optional file attachments. Max 25MB total across all attachments (after base64 decode for inline, after fetch for URL-source); max 20 attachments per email. Each entry provides either inline base64 content or a public url for server-fetch.
20Custom email headers as key-value pairs
Arbitrary key-value metadata to attach to the message
Response
OK
Full message resource representation
Unique identifier of the message
^[0-9A-HJKMNP-TV-Z]{26}$ID of the agent that sent or received the message
^[0-9A-HJKMNP-TV-Z]{26}$Communication channel used
EMAIL, SMS, MMS, VOICE Whether the message was inbound or outbound
INBOUND, OUTBOUND Current delivery status
QUEUED, SENT, DELIVERED, FAILED, BOUNCED, BLOCKED, PENDING_APPROVAL Sender address (email or phone number)
Recipient address (email or phone number)
Message subject line, or null for channels that do not support subjects
Plain-text content of the message
HTML content of the message, or null if not available
Raw message headers as key-value pairs, or null
Arbitrary metadata attached to the message, or null
Thread identifier for conversation grouping, or null
Message ID this message is replying to, or null
Provider-assigned external identifier, or null
Timestamp when the message was sent, or null if not yet sent
Timestamp when the message was received, or null for outbound messages
File attachments associated with this message
Timestamp when the message record was created
Timestamp when the message record was last updated
