IMAP (AI)Install

Summary

Set a specified IMAP flag on one or more emails identified by their UIDs within a given mailbox folder.

Inputs

• Mailbox / Folder (required) — IMAP folder path where the emails are located, e.g., INBOX, Sent, or a nested path like Archive/2026.
• UIDs (required) — One or more UIDs identifying the emails to flag; accepts a single number, comma-separated list (e.g., '1,5,9'), or range (e.g., '100:200', '1:*').
• Flag (required) — The IMAP flag to set on the emails. Use '\Flagged' for starring, '\Seen' for marking as read, or a custom keyword such as 'Important'.

Output shape

a list of JSON objects indicating the UIDs affected, the flag set, count of requested UIDs (null if wildcard used), and a success indicator

The operation performs a single IMAP request to add the specified flag to all matching messages in the specified mailbox. If no messages match the given UIDs, an error is thrown. Returned JSON includes fields uids (UID sequence string), requestedCount (number of UIDs if no wildcard or null), flag (the flag set), and added (true). The output is paired with the input item index.

Examples

Example 1: Flag messages with UID 42 and 100:200 in INBOX as starred

Mailbox: INBOX; UIDs: '42,100:200'; Flag: '\Flagged'

Links

• n8n community nodes installation guide