Skip to main content
POST
Create a Gmail draft or threaded reply draft without attachments

Body

application/json
to
string
required

Recipient email address.

Required string length: 3 - 320
subject
string
required

Draft subject line. For replies or forwards, include threadId; subjects starting with Re: or Fwd: are rejected without threadId so the draft stays on the existing conversation.

Required string length: 1 - 500
body
string
required

Plain-text draft body. Write plain prose with no markdown syntax, separate paragraphs with blank lines, and do not hard-wrap prose. For threaded drafts, the server appends the quoted conversation automatically; do not include quoted history.

Required string length: 1 - 50000
cc
string

Optional comma-separated Cc email addresses.

Required string length: 3 - 1000
bcc
string

Optional comma-separated Bcc email addresses.

Required string length: 3 - 1000
threadId
string

Gmail thread id to reply on. Required for replies and forwards; get it from the gmail-messages capability. When set, the draft is attached to that thread as a reply — keep the thread's subject (e.g. 'Re: …').

Required string length: 1 - 512

Response

Draft created.

ok
boolean
required
draftId
string
required
messageId
string | null
required
draftUrl
string | null
required

Gmail URL for the ready-to-send draft. Always share draftUrl with the user so they can open the draft in Gmail for review and send.

threadUrl
string | null
required

Gmail URL for the conversation thread when this draft is a threaded reply.

to
string
required
subject
string
required
threadId
string | null
required
quotedHistoryIncluded
boolean
required

True when quoted conversation history was included by the server or already present in the request body.

attachments
object[]