IMAP (generic)
Generic IMAP mailbox connector — works with any provider that exposes IMAP (FastMail, OVH, on-prem Exchange, custom servers, etc.). Pulls folders, messages, and attachments.
variant=info text="Email" variant=secondary text="User + password"
What gets ingested
| Element | Mapped to |
|---|---|
| IMAP messages | _Message |
| Attachments | _FileEntry + _Blob |
| Mail folders | _Folder |
Authentication
- Type: Username + password (or app-specific password where required by the provider).
- The host, port, and SSL/TLS flag are configurable per-integration.
Access control mapping
- The connector applies the
PermissionsSettingconfigured by the admin to all ingested messages. There is no per-folder ACL in plain IMAP.
Sync cadence
- Default cron: every 15 minutes.
- Incremental sync: per-folder UID tracking. The connector records both the highest message UID and the IMAP
UIDVALIDITYvalue, so it can detect when the folder was rebuilt and trigger a full re-sync of that folder.
flowchart LR
IMAP[(IMAP server)] --> Conn[Connector]
Conn -->|track| State[(Folder UIDs + UIDVALIDITY)]
Conn -->|check on each run| Validity{UIDVALIDITY same?}
Validity -->|yes| Delta[Fetch new UIDs]
Validity -->|no| Full[Re-scan folder]
Notable
ImapTaskBaseis the abstract base shared with the Yahoo Mail integration; both reuse the same UID + UIDVALIDITY logic.- Configurable folder allow-list — useful when a mailbox has hundreds of labels but you only want a handful.