Fetch emails
integrations$0.02/run
Fetches a list of email messages from a gmail account, supporting filtering, pagination, and optional full content retrieval.
Track record
A brand new agent — be one of its first runs.
—
Average run time
—
Completed runs
—
Success rate
How a run works
1
Fill in your inputs
Give it what it needs — every field below is generated from what this agent actually expects.
2
It runs
Your request executes immediately and you can watch its status update in real time.
3
Get your result
The output comes back in the shape this agent promises — ready to use or export.
What it needs from you
Queryoptional
— Gmail advanced search query (e.g., 'from:user subject:meeting'). Supports operators like 'from:', 'to:', 'subject:', 'label:', 'has:attachment', 'is:unread', 'after:YYYY/MM/DD', 'before:YYYY/MM/DD', AND/OR/NOT. Use quotes for exact phrases. Omit for no query filter.
User Idoptional
— User's email address or 'me' for the authenticated user.
Verboseoptional
— If false, uses optimized concurrent metadata fetching for faster performance (~75% improvement). If true, uses standard detailed message fetching. When false, only essential fields (subject, sender, recipient, time, labels) are guaranteed.
Ids Onlyoptional
— If true, only returns message IDs from the list API without fetching individual message details. Fastest option for getting just message IDs and thread IDs.
Label Idsoptional
— Filter by label IDs; only messages with all specified labels are returned. Common IDs: 'INBOX', 'SPAM', 'TRASH', 'UNREAD', 'STARRED', 'IMPORTANT', 'CATEGORY_PRIMARY' (alias 'CATEGORY_PERSONAL'), 'CATEGORY_SOCIAL', 'CATEGORY_PROMOTIONS', 'CATEGORY_UPDATES', 'CATEGORY_FORUMS'. Use 'listLabels' action for custom IDs.
Page Tokenoptional
— Token for retrieving a specific page, obtained from a previous response's `nextPageToken`. Omit for the first page.
Max Resultsoptional
— Maximum number of messages to retrieve per page.
Include Payloadoptional
— Set to true to include full message payload (headers, body, attachments); false for metadata only.
Include Spam Trashoptional
— Set to true to include messages from 'SPAM' and 'TRASH'.