IMAP Trigger

Triggers when new emails are received via IMAP (works with any email provider)

This is a polling-based trigger. TradingGoose checks the source for matching changes on a regular interval.

Setup Instructions

1. Enter your IMAP server details (host, port, SSL settings)

2. Enter your email credentials (username and password)

3. For Gmail: Use an App Password instead of your regular password

4. Select the mailbox to monitor (INBOX is most common)

5. Optionally configure search criteria and processing options

6. The system will automatically check for new emails and trigger your workflow

Configuration

IMAP Server*

imap.example.com

IMAP server hostname (e.g., imap.gmail.com, outlook.office365.com)

Port*

993

IMAP port (993 for SSL/TLS, 143 for STARTTLS)

Use SSL/TLS

Enabled

Enable SSL/TLS encryption (recommended for port 993)

Verify TLS Certificate

Enabled

Verify server TLS certificate. Disable for self-signed certificates.

Username*

user@example.com

Email address or username for authentication

Password*

••••••••

Password or app-specific password (for Gmail, use an App Password)

Mailboxes to Monitor

Select mailboxes to monitor

Choose which mailbox/folder(s) to monitor for new emails. Leave empty to monitor INBOX.

Search Criteria

code

{ "unseen": true }

ImapFlow search criteria as JSON object. Default: unseen messages only.

Mark as Read

Enabled

Automatically mark emails as read (SEEN) after processing

Include Attachments

Disabled

Download and include email attachments in the trigger payload

Output Schema

Event Payload

emailobject

messageIdstringRFC Message-ID header

subjectstringEmail subject line

fromstringSender email address

tostringRecipient email address

ccstringCC recipients

datestringEmail date in ISO format

bodyTextstringPlain text email body

bodyHtmlstringHTML email body

mailboxstringMailbox/folder where email was received

hasAttachmentsbooleanWhether email has attachments

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

timestampstringEvent timestamp

IMAP Trigger

Setup Instructions

Configuration

Output Schema

On this page