Send many emails in one call
send_batchSend up to 500 distinct emails in one API call and get ordered per-message results, so one bad address does not fail the batch. Use an idempotency key to prevent duplicate sends on retries.
Instructions
Purpose: send up to 500 different messages in one call, the same ceiling as POST /emails/batch. Each item takes the same fields as send_email, including headers and attachments. NOT for: one message to many recipients — that is send_email with a list of addresses. Each To, CC and BCC recipient counts as one email. Returns: sent, failed, and one result per item IN THE ORDER YOU SENT THEM, each carrying the same code and fix a single send would have given. One bad address does not fail the batch. Each accepted item costs its own recipient count, and each To, CC and BCC recipient counts as one email. Pass an idempotency_key: a retried batch without one sends every accepted item again.
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": {
"emails": "<emails>"
},
"name": "send_batch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| emails | Yes | The emails to send (max 500 per call, the same ceiling as POST /emails/batch). | |
| 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sent | No | ||
| 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. | |
| failed | No | ||
| results | No | One result per item, in the order sent. |