Gmail Get Custom

Get one or many Messages/Threads and manage labels with token caching

Actions8

Thread → Get Many

AI-generated

Summary

Retrieve multiple Gmail threads from a specified delegated mailbox with optional filtering and control over result count and format.

Inputs

  • Service Account Email (required) — Email address of the Google Cloud service account used for authentication.
  • Private Key (required) — Private key of the service account, used to obtain an OAuth access token.
  • Delegated Email (required) — Email address of the Gmail account to access (user to impersonate).
  • Return All — Choose to retrieve all matching threads or limit the number returned.
  • Limit — Maximum number of threads to return if not returning all, capped at 500.
  • Simplify — Whether to return simpler thread data with key headers flattened or full raw API response.
  • Filters — Collection of filtering options including including spam/trash messages, label IDs, Gmail search queries, read status, received date range, and sender address.

Output shape

a list of thread objects, each wrapped in an item with a json property; the thread data is either simplified or raw per input parameter

If 'simplify' is true, each thread's messages have key headers flattened for easier access. The operation paginates as needed to obtain all results if 'Return All' is true. Filtering applies Gmail query syntax and label filters. Returns an empty list if no threads match.

Links

Discussion