Send email (sends real email)
send_emailSends transactional email through Cresca with HTML/text or templates, optional attachments and scheduling, using an idempotency key to prevent duplicate sends.
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. Sends one transactional email to up to 50 recipients (to + cc + bcc), with html/text or a published template, optional attachments, tags, custom headers and scheduling up to 30 days ahead.
Works with sending-access and full-access API keys. The from address must be an active sender on a verified domain. Recipients on the suppression list are skipped and the call still succeeds.
idempotency_key is required: build it from the event ("order-confirmation/1042") and reuse it on every retry. If the result says already_sent, the email went out earlier: the task is done, do not retry with a new key. Returns { id }; check delivery with get_email.
Use it for transactional email (password resets, receipts, alerts), not newsletters or promotions: those belong in Cresca campaigns.
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>",
"idempotency_key": "<idempotency_key>"
},
"name": "send_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | Carbon-copy recipients. | |
| to | Yes | Recipient address or array of addresses. Up to 50 recipients in total across to, cc and bcc. | |
| bcc | No | Blind carbon-copy recipients; never shown in headers. | |
| from | No | Sender, as "hello@acme.com" or "Acme <hello@acme.com>". Must be an active sender on a verified domain in the Cresca account. Required unless the template has a default sender. | |
| html | No | HTML body. Provide html, text or a template. | |
| tags | No | Up to 10 { name, value } labels, e.g. { "name": "category", "value": "password_reset" }. ASCII letters, numbers, underscores and dashes, up to 256 characters. Tag names must be unique within the email. | |
| text | No | Plain-text body. If omitted, Cresca generates it from html. An empty string leaves the text part out. | |
| headers | No | Custom headers such as List-Unsubscribe or X-Entity-Ref-ID, up to 50. Headers Cresca controls (From, To, Cc, Bcc, Subject, Reply-To, Sender, Return-Path, Message-ID, Date, Content-Type and similar) are rejected; use the request fields instead. | |
| subject | No | Single line, up to 998 characters. Required unless the template has a default subject. | |
| reply_to | No | Reply-To address(es). Defaults to the template's, else the sender's Reply-To. | |
| template | No | Send a PUBLISHED template instead of html/text. Cannot be combined with html or text. subject, from and reply_to default to the template's values when omitted. | |
| attachments | No | Up to 20 files, 7 MB in total, as base64 content. Attaching by URL/path is not supported. | |
| scheduled_at | No | ISO 8601 date-time to send at, up to 30 days ahead, e.g. "2026-10-21T09:00:00Z". A time in the past sends immediately. A scheduled email can be rescheduled or canceled until it is sent. | |
| 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. |