> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Email

> Send a transactional email.

Dispatches a transactional email to one or more recipients.

### Body

**from** `string` *required*

Sender address, e.g. `Acme <hello@acme.com>`. Must match a verified domain.

**to** `string[]` *required*

List of recipient email addresses (up to 50).

**subject** `string` *required*

Email subject line.

**html** `string`

HTML message body. Required if `text` or `template_id` is not provided.

**text** `string`

Plaintext message body. Required if `html` or `template_id` is not provided.

**template\_id** `string`

ID or slug of a pre-configured template. When provided, neither `html` nor `text` should be sent.

**variables** `object`

Key-value dictionary of dynamic merge variables used with `template_id`.

**cc** `string[]`

Carbon copy recipient email addresses.

**bcc** `string[]`

Blind carbon copy recipient email addresses.

**reply\_to** `string[]`

Reply-to email addresses.

**scheduled\_at** `string`

ISO-8601 timestamp to schedule the email for future delivery (e.g. `2026-10-01T12:00:00Z`).

**headers** `object`

Custom email headers (e.g. `{"X-Entity-Ref-ID": "123"}`).

**tags** `object[]`

Custom metadata tags for categorization (array of `{ name: string, value: string }`).

**attachments** `object[]`

Array of file attachments (`{ filename: string, content: string }`).

### Response

**id** `string`

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.