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 → Copy

AI-generated

Summary

Copy one or more email messages by their UIDs from a specified IMAP folder to a target folder, preserving the original messages in the source folder.

Inputs

  • Mailbox / Folder (required) — The source IMAP folder path containing the messages to copy (e.g., INBOX, Sent, Archive/2026, [Gmail]/All Mail).
  • UIDs (required) — One or more message UIDs to copy, specified as a single number, a comma-separated list (e.g., "1,5,9"), or a range (e.g., "100:200", "1:*"). All matched messages are processed in one IMAP round-trip.
  • Target Folder (required) — The destination IMAP folder path where the messages will be copied.

Output shape

a single record in JSON format describing the copy result

The JSON output includes properties: 'copied' (boolean, true if copy succeeded), 'uids' (the original UID sequence string), 'requestedCount' (number of messages requested for copy, or null if wildcard used), 'target' (target folder path), and 'result' (the raw IMAP library response). If no messages match or the copy fails, an error is thrown.

Examples

Example 1: Copy emails with UIDs "1,5,9" from 'INBOX' to 'Archive/2026'

Set Mailbox / Folder to 'INBOX', UIDs to '1,5,9' and Target Folder to 'Archive/2026'.

Links

Discussion