Skip to main content
POST
List messages in the connected Gmail mailbox

Body

application/json
approval
string

Approval id the account owner approved for this exact action (from a CONNECTOR_APPROVAL_REQUIRED answer)

connector
string

Your connection id (defaults to your default Google connection, else the newest active one); only on your own turns

cursor
string

Page token for the next page (Gmail nextPageToken)

label
string

Filter by label id (repeat for multiple)

max
string

Max messages to return (1-100, default 25)

q
string

Gmail search query (same as the web search bar)

shared
boolean

In your own chat with this agent (or a group its shared account covers), use its shared account instead of yours (the agent must be in shared mode)

Response

Success — body conforms to the @Returns schema.

capability
string
required
refreshed
boolean
required
result