Imap Trigger
Triggers when new emails are received via IMAP (works with any email provider)
Triggers when new emails are received via IMAP (works with any email provider)
This is a polling-based trigger. TradingGoose automatically checks for new data on a regular interval.
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
Disabled
Enable SSL/TLS encryption (recommended for port 993)
Verify TLS Certificate
Disabled
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
Disabled
Automatically mark emails as read (SEEN) after processing
Include Attachments
Disabled
Download and include email attachments in the trigger payload
Output Schema
Event Payload
emailobjectmessageIdstringRFC Message-ID headersubjectstringEmail subject linefromstringSender email addresstostringRecipient email addressccstringCC recipientsdatestringEmail date in ISO formatbodyTextstringPlain text email bodybodyHtmlstringHTML email bodymailboxstringMailbox/folder where email was receivedhasAttachmentsbooleanWhether email has attachmentsattachmentsfile[]Array of email attachments as files (if includeAttachments is enabled)timestampstringEvent timestamp