Send email

POST /emails

Send a transactional email. Returns the email id immediately; delivery events arrive through webhooks and the Logs page.

FieldTypeDescription
fromstringrequiredSender address on a verified domain. Use "Name <email@domain>" to set a display name.
tostring | string[]requiredRecipient address or up to 50 addresses.
subjectstringrequiredEmail subject line. Optional when you send a template.
htmlstringHTML body. Provide html, text or template.
textstringPlain-text body. Generated from html when omitted.
ccstring | string[]Carbon-copy recipients.
bccstring | string[]Blind carbon-copy recipients.
reply_tostring | string[]Where replies go.
templateobjectSend a published template: { "id": "alias-or-id", "variables": { … } }.
scheduled_atstringISO 8601 date or a phrase like "in 1 hour" or "tomorrow at 9am" (UTC). Up to 30 days ahead.
tagsobject[]Name/value pairs attached to the email and its webhook events. Letters, numbers, _ and - only.
headersobjectCustom email headers.
attachmentsobject[]{ filename, content } with base64 content. Up to 40 MB per email.

More guides