Gmail Trigger

Triggers when new emails are received in Gmail (requires Gmail credentials)

This is a polling-based trigger. TradingGoose automatically checks for new data on a regular interval.

Use as a Tool

See workflow actions, operations, and tool inputs for Gmail.

Configuration

Credentials*

Connect account...

This trigger requires google email credentials to access your account.

Gmail Labels to Monitor

Select Gmail labels to monitor for new emails

Choose which Gmail labels to monitor. Leave empty to monitor all emails.

Label Filter Behavior*

Select...

Include only emails with selected labels, or exclude emails with selected labels

Gmail Search Query

subject:report OR from:important@example.com

Optional Gmail search query to filter emails. Use the same format as Gmail search box (e.g., "subject:invoice", "from:boss@company.com", "has:attachment"). Leave empty to search all emails.

Mark as Read

Disabled

Automatically mark emails as read after processing

Include Attachments

Disabled

Download and include email attachments in the trigger payload

Output Schema

Event Payload

emailobject

idstringGmail message ID

threadIdstringGmail thread ID

subjectstringEmail subject line

fromstringSender email address

tostringRecipient email address

ccstringCC recipients

datestringEmail date in ISO format

bodyTextstringPlain text email body

bodyHtmlstringHTML email body

labelsstringEmail labels array

hasAttachmentsbooleanWhether email has attachments

attachmentsfile[]Array of email attachments as files (if includeAttachments is enabled)

timestampstringEvent timestamp

Gmail Trigger

Use as a Tool

Configuration

Output Schema

On this page