Send message
Tool ID: email_message_send
Summary
Composes and sends an email from a configured mailbox via SMTP. A copy is saved to Sent when possible. Requires your explicit confirmation. Use a dry run first to validate recipients and content without sending.
When to use it
- Send in one step — You already know the content and want it delivered after confirm (no draft step).
- Validate first — Dry-run to check allowlist, recipient count, and body length.
- Default mailbox — “Send an email to…” without naming an account uses the default mailbox.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| Email credentials | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
to |
Yes | One or more recipients. |
subject |
Yes | Subject line. |
body |
Yes | Message body (length limited by mailbox config). |
cc |
No | Carbon-copy recipients. |
bcc |
No | Blind carbon-copy recipients. |
mailbox |
No | Account id. Omit for the default mailbox. |
confirm |
Yes to send | Must be true to actually send. |
dry_run |
No | If true, validate only — do not send. |
idempotency_key |
No | Optional key echoed back so retries can be tracked in your workflow. |
Recipients must pass allowed send domains when configured. Total unique recipients (to + cc + bcc) must stay within max recipients per send.
What you get back
Dry run: who would receive the mail, subject, from address, and a reminder to confirm to send.
After a confirmed send: sent: true, SMTP result details, and Sent-folder info when a copy was saved.
Example prompts
Dry-run an email to jane@example.com with subject “Quote attached” and a short professional body. Do not send.
Send that email now — I confirm.
From the sales mailbox, email customer@example.com about the delayed shipment. CC ops@example.com. Ask me to confirm before sending.
Send a thank-you note to alex@example.com from the default account. Confirm with me first.
Tips
- Prefer dry-run for new contacts — Catch domain blocks and overlong bodies before delivery.
- Drafts alternative — For careful review, create a draft instead of sending immediately.
- Confirm — The AI must not send until you clearly approve.