Send drafts (batch)
Tool ID: email_drafts_send
Summary
Sends up to five of the newest drafts in one call (default three, to stay within typical assistant timeouts). Each sent draft is copied to Sent and removed from Drafts. Requires confirmation. Repeat until no drafts remain.
When to use it
- Flush a queue of drafts — You prepared several messages and want them sent in batches.
- After creating many drafts — Faster than sending each uid one by one.
- Dry-run a batch — Preview which drafts would go out before confirming.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| Email credentials | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
mailbox |
No | Account id. Omit for the default mailbox. |
limit |
No | How many newest drafts to send this call (1–5). Default: 3. |
folder |
No | Drafts folder. Default: Drafts. |
sent_folder |
No | Preferred Sent folder. Default: Sent. |
confirm |
Yes to send | Must be true to actually send. |
dry_run |
No | If true, list what would be sent — no send and no deletions. |
What you get back
| Field | Meaning |
|---|---|
requested / attempted / sent / failed |
How the batch went |
remaining_estimate |
Drafts likely still waiting; call again if greater than zero |
results |
Per-draft outcomes |
Dry run returns the drafts that would be sent (uid, to, subject, and similar) without delivering them.
Example prompts
Dry-run sending the next 3 drafts — show subjects and recipients only.
I confirm: send the next 3 newest drafts from the default mailbox.
Keep sending batches of 5 drafts until the Drafts folder is empty. Confirm each batch with me first.
Tips
- Timeouts — Smaller batches (default 3) are safer with slow SMTP. If a call times out, list drafts and continue.
- Repeat — When
remaining_estimateis above zero, ask to send another confirmed batch. - One draft only — Prefer Send a draft when you have a specific uid.