Create draft
Tool ID: email_draft_create
Summary
Creates a draft in the mailbox Drafts folder. The message is not sent. You can review it later, then send it with Send a draft after you confirm.
When to use it
- Prepare carefully — Write now, send after review.
- Batch later — Create several drafts, then send them in a batch.
- Safer than immediate send — Prefer drafts when the content or recipients need a second look.
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. |
cc |
No | Carbon-copy recipients. |
bcc |
No | Blind carbon-copy recipients. |
mailbox |
No | Account id. Omit for the default mailbox. |
folder |
No | Drafts folder name. Default: Drafts (Gmail may use [Gmail]/Drafts). |
Recipients must pass your organization’s allowed send domains when that list is configured.
What you get back
| Field | Meaning |
|---|---|
mailbox, from_email |
Account and from address used |
to, cc, bcc, subject |
What was saved |
folder, uid |
Where the draft lives and its IMAP id (needed to send it) |
message_id |
Draft message id when available |
Example prompts
Draft an email to jane@example.com with subject “Meeting tomorrow” and a short polite body confirming 10:00. Do not send it yet.
Create a draft from the sales mailbox to the customer about shipping delay; CC my manager at manager@example.com. Leave it in Drafts.
Write three separate drafts to these three addresses with personalized thank-you notes. Do not send.
Tips
- Not sent — Creating a draft never delivers mail. Sending requires a separate confirm step.
- Keep the uid — To send one draft later, the AI needs the draft’s
uid(and folder if it is not the usual Drafts folder). - Folder names — If create fails on Drafts, list folders for the correct name.