Skip to content

Google: Lists the drafts in the user's mailbox For more information, see Create and send draft emails (https: developers google com workspace gmail api guides drafts) — response body

Lists the drafts in the user's mailbox. For more information, see [Create and send draft emails](https://developers.google.com/workspace/gmail/api/guides/drafts).: response body. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Lists the drafts in the user's mailbox For more information, see Create and send draft emails (https: developers google com workspace gmail api guides drafts) — response body

FieldTypePresenceDescription and constraints
$objectRoot
draftsarrayOptionalList of drafts. Note that the `Message` property in each `Draft` resource only contains an `id` and a `threadId`. The [`messages.get`](https://developers.google.com/workspace/gmail/api/v1/reference/users/messages/get) method can fetch additional message details.
drafts[]ModelEach itemExpand Gets the specified draft For more information, see Create and send draft emails (https: developers google com workspace gmail api guides drafts) — response body
nextPageTokenstringOptionalToken to retrieve the next page of results in the list.
resultSizeEstimateJSONOptional
resultSizeEstimate (anyOf 1)integerAlternativeEstimated total number of results.
Format: uint32
resultSizeEstimate (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Referenced models: Gets the specified draft For more information, see Create and send draft emails (https: developers google com workspace gmail api guides drafts) — response body

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.