Gmail Trigger Nexviahub icon

Gmail Trigger Nexviahub

Fetches emails from Gmail and starts the workflow on specified polling intervals.

Gmail Trigger Nexviahub

AI-generated

Summary

Polls Gmail on the configured schedule for newly received messages and emits matching emails as workflow items. Choose OAuth2 or service account authentication, then filter by Gmail search query, labels, sender, and read status.

Inputs

  • Poll Times (required) — Set when polling runs: at a standard interval, every specified number of minutes or hours, or on a custom cron schedule.
  • Authentication (required) — Choose OAuth2 or Service Account. OAuth2 uses the required Client ID, Client Secret, and Refresh Token fields; Access Token is also declared as required. Service Account uses the node's Google API credentials.
  • Event (required) — The available event is Message Received.
  • Simplify — Defaults to true. Simplified output includes message metadata with headers promoted to top-level fields and label IDs resolved to labels. Turn it off for parsed raw email output.
  • Filters — Optionally include spam/trash or drafts; select labels; enter a Gmail search query; and filter by read status or sender. Read Status defaults to unread. Sender and read status are added to the Gmail search query.
  • Options — Available when Simplify is off. Download Attachments defaults to false; when enabled, parsed attachments are added as binary properties named with the configured Attachment Prefix and a zero-based index.

Output shape

One n8n item per matching message, returned as a batch; returns no items when there are no results.

With Simplify enabled, each item contains simplified Gmail message JSON. With Simplify disabled, each item contains parsed raw email fields and may include binary attachment properties if downloads are enabled. Polling tracks the last checked message time and possible duplicates in node static data; manual execution requests at most one message.

Links

Discussion