Send email
send_emailDestructive
Send an email. Provide subject + html/text, or a published template_id / template_alias with optional variables. Set scheduled_at to send later (cancel with cancel_email).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | Cc recipients: one address, several separated by commas, or an array of addresses | |
| to | Yes | Recipients: one address, several separated by commas, or an array of addresses | |
| bcc | No | Bcc recipients: one address, several separated by commas, or an array of addresses | |
| from | Yes | Sender address on a verified domain (or `Name <address>`). Before a domain is verified, use the sandbox sender noreply@mail.ranla.ai and send only to the account email. | |
| html | No | HTML body. Send html, text or both, unless you use a template | |
| tags | No | Tags as name → value, for filtering and webhooks | |
| text | No | Plain-text body. Sent alongside html, or on its own | |
| headers | No | Extra email headers as name → value | |
| subject | No | Optional when using a published template | |
| category | No | Default transactional. product and newsletter add an unsubscribe link and skip recipients who opted out of that category. | |
| reply_to | No | Reply-To: one address, several separated by commas, or an array of addresses | |
| variables | No | Template variables when using template_id or template_alias | |
| template_id | No | Published template id | |
| unsubscribe | No | Add a managed unsubscribe link to this send | |
| scheduled_at | No | ISO 8601 time to send, e.g. 2026-10-01T09:00:00Z | |
| template_alias | No | Published template alias | |
| idempotency_key | No | Retry-safe key: the same key within 24 hours returns the first send instead of sending twice |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Email id (msg_…) | |
| status | Yes | Delivery status, e.g. queued, scheduled, sent, cancelled |