POST /emails
Send a transactional email. Returns the email id immediately; delivery events arrive through webhooks and the Logs page.
| Field | Type | Description | |
|---|---|---|---|
from | string | required | Sender address on a verified domain. Use "Name <email@domain>" to set a display name. |
to | string | string[] | required | Recipient address or up to 50 addresses. |
subject | string | required | Email subject line. Optional when you send a template. |
html | string | HTML body. Provide html, text or template. | |
text | string | Plain-text body. Generated from html when omitted. | |
cc | string | string[] | Carbon-copy recipients. | |
bcc | string | string[] | Blind carbon-copy recipients. | |
reply_to | string | string[] | Where replies go. | |
template | object | Send a published template: { "id": "alias-or-id", "variables": { … } }. | |
scheduled_at | string | ISO 8601 date or a phrase like "in 1 hour" or "tomorrow at 9am" (UTC). Up to 30 days ahead. | |
tags | object[] | Name/value pairs attached to the email and its webhook events. Letters, numbers, _ and - only. | |
headers | object | Custom email headers. | |
attachments | object[] | { filename, content } with base64 content. Up to 40 MB per email. |