IMAP Enhanced CustomInstall

Summary

Retrieve multiple emails from specified mailboxes on an IMAP server, supporting extensive search filters, flags, date ranges, and selective inclusion of email parts.

Inputs

• Credential Type (required) — Choose between using credentials saved directly in this node or credentials from an existing n8n IMAP Trigger node.
• Mailbox Names or IDs (required) — Select one or more mailboxes by name or ID to search for emails, with option to search all available mailboxes.
• Date Range — Optionally specify a start (since) and/or end (before) date to filter emails by their date.
• Flags — Filter emails by their status flags such as answered, deleted, draft, flagged, recent, and seen (read).
• Custom Labels — Filter emails by key-value pairs of custom labels (keywords) set on emails.
• Search Filters — Apply case-insensitive text filters to email fields including BCC, CC, From, Subject, Text content, To, or specify UIDs for exact matching. All filters combine with AND logic.
• Include Message Parts — Specify which parts of emails to include in the output, such as text content, HTML content, attachments info, flags, size, headers (with options for all or selected headers), and body structure.
• Include All Headers — When including headers, choose whether to include all headers or limit to a comma-separated list of specific headers.
• Headers to Include — Provide a comma-separated list of specific headers to include when 'Include All Headers' is false.
• Limit — Set the maximum number of emails to return from the search results.

Output shape

a list of email objects with requested message parts and metadata.

The operation connects to the IMAP server with the selected credentials, retrieves emails matching the specified filters and range, and returns structured email data. If headers are included, the output respect the 'Include All Headers' and 'Headers to Include' settings. The result respects the requested limit on returned emails, defaulting to 50.