Gmail Trigger node documentation
Learn how to use the Gmail Trigger node in n8n. Follow technical documentation to integrate Gmail Trigger node into your workflows.
Gmail Trigger node
Gmail is an email service developed by Google. The Gmail Trigger node can start a workflow based on events in Gmail.
Credentials
You can find authentication information for this node here.
Examples and templates
For usage examples and templates to help you get started, refer to n8n's Gmail Trigger integrations page.
Events
- Message Received: The node triggers for new messages at the selected Poll Time.
Node parameters
Configure the node with these parameters:
- Credential to connect with: Select or create a new Google credential to use for the trigger. Refer to Google credentials for more information on setting up a new credential.
- Poll Times: Select a poll Mode to set how often to trigger the poll. Your Mode selection will add or remove relevant fields. Refer to Poll Mode options to configure the parameters for each mode type.
- Simplify: Choose whether to return a simplified version of the response (turned on, default) or the raw data (turned off).
- The simplified version returns email message IDs, labels, and email headers, including: From, To, CC, BCC, and Subject.
Node filters
Use these filters to further refine the node's behavior:
- Include Spam and Trash: Select whether the node should trigger on new messages in the Spam and Trash folders (turned on) or not (turned off).
- Label Names or IDs: Only trigger on messages with the selected labels added to them. Select the Label names you want to apply or enter an expression to specify IDs. The dropdown populates based on the Credential you selected.
- Search: Enter Gmail search refine filters, like
from:, to trigger the node on the filtered conditions only. Refer to Refine searches in Gmail for more information. - Read Status: Choose whether to receive Unread and read emails, Unread emails only (default), or Read emails only.
- Sender: Enter an email or a part of a sender name to trigger only on messages from that sender.
Related resources
n8n provides an app node for Gmail. You can find the node docs here.
View example workflows and related content on n8n's website.
Refer to Google's Gmail API documentation for details about their API.
Common issues
For common questions or issues and suggested solutions, refer to Common issues.
Last updated on
Facebook Trigger Workplace Security object documentation
Learn how to use the Workplace Security object of the Facebook Trigger node in n8n. Follow technical documentation to integrate the Facebook Trigger node's Workplace Security object into your workflows.
Gmail Trigger node common issues
Documentation for common issues and questions in the Gmail Trigger node in n8n, a workflow automation platform. Includes details of the issue and suggested solutions.