Agentiff Gmail API icon

Agentiff Gmail API

Interact with Gmail API using injected access tokens from Agentiff.AI

Actions4

Message → List

AI-generated

Summary

List Gmail messages for the authenticated user applying optional filters and pagination.

Inputs

  • Access Token Source (required) — Choose whether to use the access token from a previous node or provide a custom expression.
  • Access Token (required) — Provide a custom Gmail API access token if 'Custom Expression' is selected above.
  • Max Results — Set the maximum number of messages to return; defaults to 10.
  • Query — Input a Gmail search query string to filter messages (e.g., "from:example@gmail.com subject:invoice").
  • Label IDs — Provide a comma-separated list of Gmail label IDs to filter messages (e.g., "INBOX,UNREAD").
  • Include Spam Trash — Optionally include messages from SPAM and TRASH folders when set to true.
  • Page Token — Provide a page token to paginate through results.

Output shape

a list of Gmail message metadata objects as returned by the Gmail API's messages.list endpoint

The result respects filters such as maximum results, query, and label IDs. Pagination is supported via the 'Page Token' input. Message details beyond metadata are not included; for full message data use the 'Get' operation.

Links

Discussion