Send an email from my domain
email_sendDestructive
Use this when the member asks to send or email someone from their own business domain (Connections Send). Sends ONE real message, now or at a scheduled time; it lands in the recipient's inbox and cannot be recalled, and dry_run:true returns the exact message without sending it. The sender must be on a domain this workspace has connected and verified. When nothing goes out, the reply is an error naming why: a suppressed recipient, an unverified domain, a spent daily ceiling, or no credits. email_sent reads what went out and what happened to each message; email_drafts saves one to finish later.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | Optional carbon-copy recipients. | |
| to | Yes | One recipient address, or several. | |
| bcc | No | Optional blind-copy recipients. | |
| from | Yes | The sender, on a domain this workspace has connected and verified. May be 'Name <you@yours.com>'. | |
| html | No | The HTML body. Not with `template`. | |
| text | No | The plain-text body. Send text, html, or both. Not with `template`. | |
| person | No | Linked person to run this call as (first name). Omit to run as the connection's holder. | |
| dry_run | No | true previews the exact call with nothing sent. | |
| project | No | Workspace to run this call in (id or name). | |
| subject | No | The subject line. Required unless `template` names a stored template that carries one. | |
| audience | No | Does this person already know the sender? warm = they know you or asked for this mail; cold = no prior relationship. Required for every recipient, no default: a send with no audience returns an error. One value covers the whole message; recipient_audience sets it per address and wins. | |
| reply_to | No | Where replies should go, when that is not the sender. | |
| template | No | The name of a template stored in this workspace (e.g. 'order-receipt'), used INSTEAD of text/html. Its placeholder values go in `variables`. | |
| variables | No | Values for the template's {{placeholders}}, as a flat object. Every placeholder needs one. | |
| references | No | The thread's earlier Message-IDs, oldest first (the References header of the message being answered). Only read with in_reply_to, which is appended when missing. | |
| in_reply_to | No | When this answers an email someone sent (a vendor's support ticket, say): that message's Message-ID, e.g. '<abc@zendesk.com>'. The reply then joins their existing thread; without it, their system opens a new one. | |
| scheduled_at | No | Optional send time: an ISO instant WITH a timezone ('2026-10-01T09:00:00Z') or a relative time ('in 2 hours'). A time with no timezone returns an error asking for the zone. Omit to send now. | |
| idempotency_key | No | Your own key for this message. Sending the same key twice returns the first result instead of sending again - set it whenever a retry is possible. | |
| recipient_audience | No | The audience per address, as a flat object whose values are 'warm' or 'cold': { 'person@yours.com': 'warm' }. Wins over audience for the addresses it names. |