IMAP AdvancedInstall

Summary

Fetch full thread starting from a base message, resolve related messages via Message-ID references, and return complete metadata for each message.

Inputs

• mailbox — Mailbox to query (default: INBOX). Always applicable.
• identifierType (required) — Identifier type to locate the base message: 'uid' uses the UID parameter, 'messageId' uses the Message-ID parameter.
• uid (required) — UID of the base message. Required when identifierType is 'uid'.
• messageId (required) — Message-ID of the base message. Required when identifierType is 'messageId'.
• threadStrategy — Strategy for resolving thread members. 'referencesThenSubject' (default) follows Message-ID references and optionally falls back to subject search; 'strictReferences' follows only Message-ID references without subject fallback.
• subjectFallback — When true and threadStrategy is 'referencesThenSubject' and the reference chain contains at most one message, additionally searches by the base message's subject to locate additional thread members.

Output shape

{ messageUid: number, references: string[], strategy: string, total: number, messages: [{ uid: number, subject: string, date: string, flags: string[], matchedBy: string }] }

Returns the base message UID, the parsed Message-ID references from the base envelope, the applied threadStrategy, the total count of messages in the resolved thread, and an array of per-message metadata including UID, subject, date, flags, and whether each message was located via its own Message-ID ('messageId') or subject fallback ('subject').

Examples

Example 1: Retrieve an entire support-thread given the base message's UID 12345 in INBOX.

identifierType: uid, uid: 12345, mailbox: INBOX, threadStrategy: referencesThenSubject, subjectFallback: false

Links

• n8n community nodes installation guide