Preflight an email
preflight_emailDry-run an email before sending: validate every gate—domain, suppression, budget, loop guard, content scan—and preview the exact ok/error response without spending budget or delivering anything.
Instructions
Purpose: find out exactly what a send would do, without doing it. Runs every gate a real send runs — validation, sending domain, sandbox, trust, suppression, budget, loop guard, content scan. NOT for: sending. Nothing leaves and no budget is spent, ever. Free and unlimited on purpose. Returns: the same ok/error POST /emails would return for the same payload, plus each gate's own verdict, and simulated: true when every recipient is a simulator address. The arguments are the same ones send_email takes: copies, headers, attachments, an inline image content_id, a template and a topic.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"to": "<to>"
},
"name": "preflight_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | Carbon-copy addresses — one string or a list. | |
| to | Yes | One recipient address, or a list of up to 50. A bare string is fine. | |
| bcc | No | Blind carbon-copy addresses — one string or a list. | |
| from | No | Sender address, e.g. "Acme <hello@acme.com>". Optional when template_id names a template with a default sender; one given here overrides it. | |
| html | No | HTML body. Provide html, text or template_id. | |
| tags | No | Your own labels, returned on every event for this message. | |
| text | No | Plain-text body. Provide html, text or template_id. | |
| headers | No | Extra RFC 5322 headers. | |
| subject | No | Subject line. Optional when template_id names a template that has one. | |
| reply_to | No | Where replies should go, if not the from address. | |
| timezone | No | Time zone for a scheduled_at phrase such as "tomorrow 9am". An ISO time ignores this. Example: America/Los_Angeles. Omitted phrases are read in UTC. | |
| topic_id | No | Subscription topic. Naming one screens every recipient against what they said about that topic. | |
| attachments | No | Files to attach (max 100). One with content_id is an inline image. | |
| template_id | No | The id or the alias of a published template to send instead of an inline body. Its subject, from and reply_to are used unless you pass your own. | |
| scheduled_at | No | ISO 8601 time, or a short phrase ("in 1 hour", "tomorrow 9am"). | |
| idempotency_key | No | Your own key for this action. Retrying with the same key returns the first result instead of doing it twice — send one whenever a retry could double the effect. | |
| template_values | No | Values for the template variables. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | No | What the real send would answer. | |
| error | No | The refusal the real send would return, or null. | |
| checks | No | Each gate by name, with what it found. | |
| simulated | No | True when every recipient is a simulator address. |