Skip to main content
POST
Send Email
Dispatches a transactional email to one or more recipients.

Body

string
required
Sender address, e.g. Acme <hello@acme.com>. Must match a verified domain.
string[]
required
List of recipient email addresses (up to 50).
string
required
Email subject line.
string
HTML message body. Required if text or template_id is not provided.
string
Plaintext message body. Required if html or template_id is not provided.
string
ID or slug of a pre-configured template. When provided, neither html nor text should be sent.
object
Key-value dictionary of dynamic merge variables used with template_id.
string[]
Carbon copy recipient email addresses.
string[]
Blind carbon copy recipient email addresses.
string[]
Reply-to email addresses.
string
ISO-8601 timestamp to schedule the email for future delivery (e.g. 2026-10-01T12:00:00Z).
object
Custom email headers (e.g. {"X-Entity-Ref-ID": "123"}).
object[]
Custom metadata tags for categorization (array of { name: string, value: string }).
object[]
Array of file attachments ({ filename: string, content: string }).

Response

string
Unique message identifier (msg_... or UUID).