Send an email
send_emailSend an email from a verified workspace sender.
Plain-text emails still have sending, delivery and bounce events.
Without ``from_``, one verified custom domain takes priority over the Hail mail address.
Several verified custom domains require an explicit ``from_`` address.
A custom domain blocked from sending (``sends_enabled`` false, PATCH ``/v1/email-domains/{id}``) is skipped for picks and refuses an explicit ``from_``.
When configured, a workspace without a sender receives a Hail mail address automatically.
Hail does not verify consent.
Returns the email ID, status, sender, recipients and ``idempotency_key``, or an error.
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>",
"subject": "<subject>",
"recipient_consent": "<recipient_consent>"
},
"name": "send_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | Email addresses to copy; every recipient sees them. | |
| to | Yes | Email addresses of the people the message is for. | |
| bcc | No | Email addresses to copy in secret: they get the message, and no other recipient sees their addresses. | |
| from_ | No | Sender address. It must match a verified identity from ``list_email_domains``; on a custom domain any local part works. Omitted: the workspace default sender. | |
| subject | Yes | Subject line the recipients see in their inbox. | |
| metadata | No | Free-form JSON object stored on the email record. | |
| reply_to | No | Address that receives replies instead of the sender. Omitted: replies go to the sender. | |
| body_html | No | The message as HTML. Open and click tracking works only with an HTML body. Give this, ``body_text``, or both. | |
| body_text | No | The message as plain text, shown by mail apps that cannot display HTML. Give this, ``body_html``, or both. | |
| from_name | No | Display name for the From header, such as ``Acme Billing``. Control characters are rejected. | |
| llm_model | No | Model ID of the calling agent. Optional. Recorded for analytics only. | |
| message_type | No | ``informational`` for transactional or service messages, or ``marketing``. | informational |
| attachment_ids | No | Attachment IDs: the ``id`` from ``upload_email_attachment``, or from ``create_file_upload`` with purpose ``email_attachment``. | |
| consent_source | No | Where or how consent was obtained, such as ``signup form``. Required when ``message_type`` is ``marketing``. | |
| idempotency_key | No | Retry key. The ``idempotency_key`` from an earlier response refers to that original request instead of starting a new one. Omitted: a new key is generated and returned. | |
| recipient_consent | Yes | Attestation that the recipient lawfully agreed to be contacted, as the user confirmed it. Hail does not check it; only ``true`` is accepted. | |
| consent_obtained_at | No | When consent was obtained, as an ISO 8601 timestamp, if known. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||