IMAP (AI) icon

IMAP (AI)

Read, search, move, flag and download emails from any IMAP server. Fully usable as a tool from AI Agent nodes.

Actions19

Email → Move

AI-generated

Summary

Move one or more emails identified by their UIDs from a specified source mailbox to a target folder on the IMAP server.

Inputs

  • Mailbox / Folder (required) — Source IMAP folder path containing the emails to move, e.g., INBOX, Sent, or [Gmail]/All Mail.
  • UIDs (required) — One or more unique identifiers (UIDs) of the emails to move. Accepts single numbers, comma-separated lists (e.g., "1,5,9"), or ranges (e.g., "100:200", "1:*").
  • Target Folder (required) — Destination IMAP folder path where the emails will be moved.

Output shape

a single JSON object confirming the move with fields: moved (boolean), uids (string of requested UIDs), requestedCount (number or null if wildcard used), target (string of destination folder), and result (IMAP server response).

If the move operation fails because no messages matched the given UIDs or the target folder does not exist, an error is thrown. The requestedCount is null if a wildcard UID range was provided.

Examples

Example 1: Move emails with UIDs 42 and 45 from INBOX to Archive/2026 folder.

Set Mailbox to INBOX, UIDs to "42,45", and Target Folder to "Archive/2026".

Links

Discussion