List drafts
Tool ID: email_drafts_list
Summary
Lists drafts in the Drafts folder (newest first) so you can review what is waiting to be sent. Soft cap of 500 drafts per call.
When to use it
- Review before sending — See subjects and recipients of pending drafts.
- Find a uid — Get the id needed to send one draft.
- After creating several drafts — Confirm they all saved before a batch send.
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. |
folder |
No | Drafts folder. Default: Drafts (falls back across common names, including Gmail’s). |
limit |
No | Maximum drafts to return (up to 500). Default: 500. |
What you get back
| Field | Meaning |
|---|---|
folder |
Folder that was listed |
total / count |
How many drafts exist vs how many were returned |
drafts |
Entries with uid, to, subject, date, and similar |
truncated |
Whether the list was cut by the limit |
Example prompts
List all drafts in our default mailbox.
Show the newest 20 drafts in the sales account with subject and recipients.
Do we still have drafts waiting? Summarize them for me.
Tips
- Newest first — Useful when you want to send the latest batch with Send drafts.
- Empty list — Nothing to send; create drafts first or check you are on the right mailbox.