Send batch emails (sends real email)
send_batch_emailsSends 1 to 100 different transactional emails in a single all-or-nothing request, using idempotency keys to prevent duplicate batches on retries.
Instructions
WARNING: this SENDS REAL EMAIL to real recipients through Cresca and cannot be undone (only a scheduled or still-queued email can be canceled). Confirm the recipients, sender and content with the user before calling it. Each recipient counts toward the plan's monthly email allowance.
POST /emails/batch. Sends 1 to 100 different emails in one request. Each item takes the same fields as send_email except attachments and scheduled_at, which batches do not support.
All or nothing: if any email is invalid, nothing is sent and the error names the failing email by zero-based index ("Email 3: ...").
Works with sending-access and full-access keys. idempotency_key is required and covers the whole batch: build it from the event ("weekly-digest/2026-W45") and reuse it on every retry. If the result says already_sent, the batch went out earlier: do not retry with a new key. Returns { data: [{ id }, ...] } in request order.
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>",
"idempotency_key": "<idempotency_key>"
},
"name": "send_batch_emails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| emails | Yes | 1 to 100 emails. Each item has the same fields as send_email, without attachments or scheduled_at. | |
| idempotency_key | Yes | Required. 1 to 256 characters, built from the real-world event this email is about, e.g. "order-confirmation/1042" or "password-reset/<reset request id>". Use the SAME key every time you retry or redo this email (after an error, a timeout or a restart) and a NEW key only for a genuinely new email. Never use a random value or the time. Within 24 hours a repeated key returns the first result instead of sending again. |