v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-137956179.1 KB
users

Lists the drafts in the user's mailbox. For more information, see Create and send draft emails.

get/gmail/v1/users/{userId}/drafts

Path parameters

userIdstring required

The user's email address. The special value me can be used to indicate the authenticated user.

Query parameters

includeSpamTrashboolean

Include drafts from SPAM and TRASH in the results.

maxResultsinteger

Maximum number of drafts to return. This field defaults to 100. The maximum allowed value for this field is 500.

pageTokenstring

Page token to retrieve a specific page of results in the list.

qstring

Only return draft messages matching the specified query. Supports the same query format as the Gmail search box. For example, "from:someuser@example.com rfc822msgid: is:unread".

Response

Successful response