Send draft
send_draftSends an existing email draft to its recipients and returns the sent message ID. Confirm the recipients and body first because delivery is irreversible and already-sent drafts are refused.
Instructions
Send a draft. This delivers the message to its recipients and cannot be undone. Confirm the recipients and the body with the user before calling it unless they have already asked for the message to be sent. Sends any draft in the user’s Drafts folder, not only ones you staged — find an existing one with list_drafts, and read it back with get_draft before sending something you did not write. Use the draftId create_draft returned; editing a draft with update_draft keeps it. Returns the sent message’s id, which get_email can read back. A draft that has already been sent is refused rather than sent twice.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"draftId": "<draftId>"
},
"name": "send_draft"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draftId | Yes | The draft id, as returned by create_draft, update_draft or list_drafts — edits do not change it — or a message id from search_emails with `mailbox: "Drafts"`, which an edit replaces with the draftId it returns. | |
| idempotencyKey | No | Client-chosen key that makes this call safe to retry: a repeat with the same key returns the first call’s answer instead of sending the message a second time. Pass one whenever the call might be retried. |