`sendEmail`

Send Email

Send an email via Gmail: this sends a real email and cannot be unsent.

writedestructiveexternal

Arguments

blocksobject[]optionalStructured rich email body. When present, it wins over both richBody and body.
bodystringoptionalPlain text email body. Required unless `blocks` or `richBody` is provided; when combined with either, this is the explicit text/plain part.
richBodystringoptionalMarkdown email body for formatted mail. Supports paragraphs, h1-h3 headings, bold, italic, links, lists, blockquote, inline and fenced code, horizontal rules, and image URLs. When provided, it wins over `body` for the HTML part.
accountIdstringoptionalAlias of `from`: the accountId from listMailAccounts. Takes precedence over `from` if both are given.
attachmentsobject[]optionalCloud files to attach, in order: up to 20 files, 25 MB in total. Page exports are not attachable, so attach the PDF as a Cloud file if there is one. Only promise an attachment after the result comes back with it in `attached`.
bccstringoptionalBCC email address (optional)
ccstringoptionalCC email address (optional)
docContractstringoptionalThe type-slug of the doc contract this is filed under (e.g. "handoff-memo"), when it is a staple rather than ordinary prose. The server validates the text against that contract and refuses a malformed one, handing back the contract's…
fromstringoptionalAccount to send AS: an accountId or email from listMailAccounts. Omit to send from the primary account.
overridebooleanoptionalExplicit escape hatch for a legitimate 1:1 human send to a suppressed OR recently-touched recipient. Omit/false by default: a suppressed (unsubscribed/bounced/complained) address is refused, and so is a CRM contact already touched inside…
replyAllbooleanoptionalReply to EVERYONE on the original (its sender plus every To recipient in To, its Cc in Cc), minus the user's own addresses. Only meaningful with replyToMessageId and no explicit `to`.
replyToMessageIdstringoptionalMessage ID to reply to (optional)
subjectstringrequiredEmail subject line
tostringoptionalRecipient email address. Omit ONLY when replying (replyToMessageId set): the recipients are then composed from the original message.
viastringoptionalWhich account carries the send. "gmail" (default): the user's connected Gmail. "resend-connection": their own Resend account and verified sending domain (see connectResend); replies are not supported on that rail. The consent floor is…

Returns

The registry does not declare a return shape.

Declared limits

blocks: minimum items 1
blocks: maximum items 100
attachments: maximum items 20

Ask for it

The Cloud routes these requests to this verb.

email X
send a message to Y
reply to that
reply all
email them the invoice

Pair it with

The verbs that finish the job.