mail_email_send

Tool

mail_email_send

Send a single email.

Behavior

Fails when: the sending domain is not verified
neither an inline subject/body nor a template is provided

Arguments

Name	Type	Required	Description
from	string	•	Sender, e.g. "Name <you@your-domain.com>". The domain must be verified.
to	string \| array	—	Primary recipient(s).
subject	string	—	Subject line (required for inline sends).
html	string	—	HTML body.
template	object	—	Send by reference to a published template: { id, variables }.
scheduled_at	string	—	ISO-8601 instant to send at (future, within 30 days). Omit to send now.
cc	string \| array	—	Cc recipients, as one address or an array of addresses.
bcc	string \| array	—	Bcc recipients, as one address or an array of addresses; omitted from message headers.
tags	array	—	Metadata tags, each with a string name and value.
text	string	—	Plain-text email body. Derived from html when omitted.
headers	object	—	Custom email headers as a map of string values.
reply_to	string \| array	—	Reply-To addresses, as one address or an array of addresses.

Try it

Send a welcome email from hello@example.com to jane@acme.com.

When to use

Send one transactional email — inline (subject + html/text) or by reference to a published template with variables. Supports cc/bcc, reply-to, custom headers, tags, and scheduled sends up to 30 days out. The sending domain must be verified first.

Example

Ask your agent something like this:

Send a welcome email from hello@example.com to jane@acme.com.

The agent will invoke mail_email_send with these arguments:

{
  "from": "Hello <hello@example.com>",
  "to": "jane@acme.com",
  "subject": "Welcome",
  "html": "<p>Welcome aboard!</p>"
}