Gmail Reader
This document outlines the functionality and characteristics of the Gmail Reader node, which enables automated email processing from Gmail accounts.
Node Inputs
The Gmail Reader node accepts the following inputs:
- Label: The Gmail label to read from (default: ‘INBOX’)
- Search Query: Optional Gmail search syntax to filter emails
- Number of Emails: Maximum number of emails to process. Leave blank to read all emails.
- Mark as Read: Whether to mark processed emails as read (default: False)
- Ignore Read Status: Option to include both read and unread emails
Node Output
The Gmail Reader node produces the following outputs (all in list format):
- Email Bodies: Content of the email messages
- Attachment Files: Names and contents of attached files
- Message IDs: Unique identifiers for each email
- Sender Addresses: Email addresses of senders
- Recipient Addresses: All recipients (including CC/BCC)
- Subjects: Email subject lines
- Dates: Date & timestamp of emails (in UTC)
Node Functionality
The Gmail Reader node provides automated access to Gmail inbox content and email data.
Key features include:
- Support for Gmail search syntax filtering
- Attachment handling
- Customizable email processing options
- Secure authentication with Gumloop
Trigger Functionality
This node can also function as a trigger to start your flow when new emails arrive in Gmail. Learn more about triggers in our Triggers documentation.
When To Use
The Gmail Reader node is particularly valuable in scenarios requiring automated email processing. Common use cases include:
- Customer Support: Automatically process incoming support emails
- Data Extraction: Extract information from scheduled reports
- Email Monitoring: Track important communications
- Attachment Processing: Handle incoming file attachments
Some specific examples:
- Processing order confirmations
- Collecting daily reports
- Monitoring support tickets
- Archiving attachments
Important Considerations:
- Requires Authentication with Gmail - Set up in the Credentials page
- By default, only processes unread emails
- Output types change to single
string
if reading just one email
In summary, the Gmail Reader node streamlines email processing tasks by providing automated access to Gmail content, with flexible filtering options and comprehensive data extraction capabilities.