Thanks to visit codestin.com
Credit goes to docs.sim.ai

IMAP

The IMAP Email trigger allows your Sim workflows to start automatically whenever a new email is received in any mailbox that supports the IMAP protocol. This works with Gmail, Outlook, Yahoo, and most other email providers.

With the IMAP trigger, you can:

  • Automate email processing: Start workflows in real time when new messages arrive in your inbox.
  • Filter by sender, subject, or folder: Configure your trigger to react only to emails that match certain conditions.
  • Extract and process attachments: Automatically download and use file attachments in your automated flows.
  • Parse and use email content: Access the subject, sender, recipients, full body, and other metadata in downstream workflow steps.
  • Integrate with any email provider: Works with any service that provides standard IMAP access, without vendor lock-in.
  • Trigger on unread, flagged, or custom criteria: Set up advanced filters for the kinds of emails that start your workflows.

With Sim, the IMAP integration gives you the power to turn email into an actionable source of automation. Respond to customer inquiries, process notifications, kick off data pipelines, and more—directly from your email inbox, with no manual intervention.

Triggers

A Trigger is a block that starts a workflow when an event happens in this service.

These run on a schedule (polling-based) — they check for new data rather than receiving push notifications.

IMAP Email Trigger

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

Configuration

ParameterTypeRequiredDescription
hoststringYesIMAP server hostname (e.g., imap.gmail.com, outlook.office365.com)
portstringYesIMAP port (993 for SSL/TLS, 143 for STARTTLS)
securebooleanNoEnable SSL/TLS encryption (recommended for port 993)
usernamestringYesEmail address or username for authentication
passwordstringYesPassword or app-specific password (for Gmail, use an App Password)
mailboxstringNoChoose which mailbox/folder(s) to monitor for new emails. Leave empty to monitor INBOX.
searchCriteriastringNoImapFlow search criteria as JSON object. Default: unseen messages only.
markAsReadbooleanNoAutomatically mark emails as read (SEEN) after processing
includeAttachmentsbooleanNoDownload and include email attachments in the trigger payload

Output

ParameterTypeDescription
emailobjectemail output from the tool
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

On this page