Mail

mail_email_send

Send a single email.

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.

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>"
}