List messages

developed⚡ superfast

Lists the messages in the user's mailbox.

GET /gmail/v1/users/{userId}/messagesUsersv e5d10984 · auto-generated6 runs

Input

user_id*

User ID or 'me' for the authenticated user

The user's email address or 'me' to indicate the authenticated user.

query

Search query (q)

Only return messages matching the specified query. Supports the same query format as the Gmail search box (e.g. 'from:someone@example.com is:unread').

page

Pagination token (pageToken)

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

limit

Max results (maxResults)

Maximum number of messages to return. Accepts values between 1 and 500. Defaults to 100.

label_ids

Label IDs

Only return messages with labels that match all of the specified label IDs.

include_spam_trash

Include spam and trash

Include messages from SPAM and TRASH in the results.

Calls Gmail as you (your API key is your account); keychains.dev holds the credentials.