Send email
send_emailSend one email now or at a scheduled time to one or many To, CC and BCC recipients, with templates, attachments and idempotency keys. Returns a message id and status.
Instructions
Purpose: send one email now, or at a time you name. Takes one recipient or a list. Each To, CC and BCC recipient counts as one email. NOT for: checking whether a send would work (preflight_email), sending many different messages at once (send_batch), or asking a person first (request_approval). Returns: the message id and its status, immediately. Delivery happens after; get_email has the outcome. Refusals name the gate and the cure: validation_error lists the bad fields, domain_not_verified points at verify_domain, suppressed_recipient says the address asked not to be contacted, agent_unconfirmed means every recipient has to be the human until POST /agent/verify, and recipient_ramp names when the next new recipient is allowed. Addresses ending in @simulator.agentisend.com cost nothing, reach nobody, and work before any domain is verified. from onboarding@agentisend.com delivers real mail only to this account's member sign-in addresses, 20 per UTC day, with no cc, bcc, attachments, tracking, or extra headers. Sending twice is sending twice: pass an idempotency_key and a retry returns the first message id instead of a second email.
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": "send_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 and adds the one-click unsubscribe headers for it. | |
| 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 to send at, or a phrase such as "tomorrow 9am". Future times wait; cancel or reschedule until then. | |
| 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 |
|---|---|---|---|
| id | No | Identifier. | |
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| status | No | The message status. |