Send Mailbox Message
mailbox_send_messageSend email from an authenticated mailbox, including attachments, CC/BCC, and custom headers. Supports safe retries with an Idempotency-Key.
Instructions
Use this to send a message from the authenticated mailbox. For attachments, call mailbox_upload_attachment first using file_path, presign_upload_url, or tiny content_base64, then pass the returned blob_id. Include an Idempotency-Key for retries.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | CC recipients. | |
| to | No | Primary recipients. | |
| bcc | No | BCC recipients. | |
| from | No | Sender address. Defaults to mailbox identity. | |
| subject | No | Subject line for the outgoing email. | |
| reply_to | No | Reply-To recipients. | |
| html_body | No | HTML body. | |
| text_body | No | Plain text body. | |
| mailbox_id | No | Mailbox public ID to target when the credential grants access to more than one mailbox. Omit when the credential is scoped to exactly one mailbox. | |
| attachments | No | Attachments to send with the message. | |
| custom_headers | No | Custom headers to include. | |
| Idempotency-Key | No | Client-chosen unique key to safely retry the request. Cached for 24h per (mailbox, endpoint, key). Different body with same key returns 409 idempotency_conflict. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||