App Logo
mail.google.com

Create a Gmail draft

Automatically create a Gmail draft on mail.google.com. Compose a Gmail message and save it as a draft without sending it. Takes to/cc/bcc, a subject and a plain-text body, and can put one of the account's Gmail signatures under the body by its name, or none; without that choice the draft keeps Gmail's default signature for new emails. Reports success only once Gmail confirms the draft is saved under Drafts with that subject and body, and returns the account used, the draft id that update_draft and send_draft take, and the id of its conversation. Create drafts one after another on a browser: several at once can leave Gmail without saving some of them, which the call reports as an error.

Input

to required

Recipient email address(es). A single string or an array of strings.

body required

Plain-text body.

subject required

Subject line.

cc optional

Optional Cc address(es). A single string or an array of strings.

bcc optional

Optional Bcc address(es). A single string or an array of strings.

account optional

Google account email to act as (authuser=). Without it Gmail picks u/0, nondeterministic in a multi-account jar.

signature optional

Name of one of the account's Gmail signatures to put under the body, as Gmail lists it in the composer's signature menu. An empty string means no signature. Omit it to keep what Gmail puts in a new message: the account's default signature for new emails, if one is set.

Output

status required
subject required
verifiedInDrafts required

True when Gmail confirmed the draft is saved under Drafts with this subject and body.

cc optional
to optional
bcc optional
account optional

The Gmail account the draft was saved in, as the compose window names it.

draftId optional

Gmail's id for the saved draft, the one the drafts listing returns and update_draft and send_draft take. Gmail replaces it whenever the draft is saved again.

threadId optional

Id of the conversation holding the draft. It stays the same when the draft is saved again.

signature optional

The signature chosen for this draft, by the name Gmail lists it under; an empty string when no signature was asked for; null when the call left Gmail's default in place.

verifiedBy optional

How the save was confirmed: 'server' is Gmail's own answer to the save, which echoes the saved draft; 'drafts_list' is the draft found in the Drafts list with this subject and body, used when another Gmail tab in the browser saved it.

hasSignature optional

Whether the saved draft carries a signature under the body.

FAQ

Compose a Gmail message and save it as a draft without sending it. Takes to/cc/bcc, a subject and a plain-text body, and can put one of the account's Gmail signatures under the body by its name, or none; without that choice the draft keeps Gmail's default signature for new emails. Reports success only once Gmail confirms the draft is saved under Drafts with that subject and body, and returns the account used, the draft id that update_draft and send_draft take, and the id of its conversation. Create drafts one after another on a browser: several at once can leave Gmail without saving some of them, which the call reports as an error.
Ask an AI agent connected to Reduck to run reduck/mail.google.com/create_draft, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/mail.google.com/create_draft
You do not need one. "Create a Gmail draft" drives the real mail.google.com pages in a browser, so it works whether or not mail.google.com offers an API for this.
Required: to, subject, body. Optional: cc, bcc, account, signature.
It returns cc, to, bcc, status, account, draftId, subject, threadId, signature, verifiedBy, hasSignature, verifiedInDrafts.
Yes. It acts as you on mail.google.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the mail.google.com cookies saved by the Reduck extension.
It makes changes on mail.google.com, like sending, posting, booking or buying something.
Ask an AI agent connected to Reduck to run reduck/mail.google.com/create_draft, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/mail.google.com/create_draft
It is part of Reduck's official curated catalogue.

Related scripts

mail.google.com

Search Gmail

Search the signed-in Gmail with the native query syntax (from:, to:, subject:, has:attachment, after:/before:, labels…) and return matching threads: threadId (feed it to get_thread / reply_to_email), sender, senderEmail, subject, snippet, date, unread, starred, hasAttachment. Results are threads rather than individual messages, which is Gmail's own search granularity, and only the first page of results is returned (up to 50).

mail.google.com

Send Gmail email

Send an email from the signed-in Gmail account, with a plain-text body and an optional single file attachment. Always starts a new conversation. To answer inside an existing thread, use mail.google.com/reply_to_email.

mail.google.com

Get Gmail thread

Read a Gmail thread by its hex threadId (as returned by search_emails): subject plus every rendered message's from, fromEmail, to, date, plain-text body and attachment names. In long threads Gmail collapses older messages, so only rendered (expanded) messages are returned.

Start building not clicking

Get started for free