Gmail · Productivity

Gmail API / List messages

Lists message ids in the mailbox (developers.google.com/gmail/api/reference/rest/v1/users.messages/list): q (Gmail search syntax), maxResults, labelIds and pageToken are the query fields the docs define.

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified

Published API evidence

Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

labelIds query · optional
Only return messages with all of the specified label ids.
maxResults query · optional
Max messages returned on one result page (Google default 100, max 500).
pageToken query · optional
A pageToken from a previous call's nextPageToken.
q query · optional
Gmail search query, same syntax as the Gmail search box, e.g. "from:x@y.com is:unread".

Provider docs How to run it