Sending & observability
email_send_email
Send one email to ONE primary recipient using a published template (suppression-checked, logged, rate-capped like any send).
write email_send_email
Send one email to ONE primary recipient using a published template (suppression-checked, logged, rate-capped like any send). cc/bcc carbon-copy the SAME message — not a way to blast a list; for broad sending use an automation. Supports custom headers, {name,value} tags, and scheduling (ISO or natural language like 'in 2 hours').
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
to | string | Yes | |
cc | string[] | No | |
bcc | string[] | No | |
template | string | Yes | Template slug. |
props | object | No | |
locale | string | No | Send a published translation for this locale ('fr'); falls back to base. |
replyTo | string | string[] | No | One or more reply-to addresses. |
headers | object | No | Custom email headers. |
tags | object[] | No | Provider analytics tags. |
scheduledAt | string | No | ISO timestamp or natural language ('in 2 hours', 'tomorrow 9am'). |
projectId | string | No | Target company (project id). Org-scoped tokens only; call email_list_projects first. |