IMAP Manager icon

IMAP Manager

Manage mail via IMAP (works with IONOS or any IMAP server): search, add keywords, move, copy, delete

Overview

This node manages email messages on an IMAP server, supporting operations such as listing mailboxes, searching messages by Message-ID, adding or removing keywords (tags), moving or copying messages between mailboxes, deleting messages, and marking messages as unread. It is useful for automating email management tasks, such as organizing emails into folders, tagging important messages, or cleaning up mailboxes.

Use Case Examples

  1. Automatically move emails with specific UIDs to an Archive mailbox.
  2. Add custom tags to emails for categorization and later processing.
  3. Search for emails by their Message-ID to retrieve their UIDs for further actions.
  4. Delete emails based on certain criteria automatically.

Properties

Name Meaning
Mailbox The source mailbox/folder where the email message is located.
UID The unique identifier of the email message within the mailbox, used to specify which message to operate on.
Destination Mailbox The target mailbox/folder where the message will be copied or moved to.
Create Destination If Missing If true, the destination mailbox will be created if it does not exist before moving or copying the message.

Output

JSON

  • mailboxes - List of mailboxes matching a filter, each with path, name, flags, special use, delimiter, and listed status.
  • mailbox - The mailbox involved in the operation.
  • messageId - The RFC822 Message-ID used for searching messages.
  • uids - Array of UIDs of messages found by Message-ID search.
  • uid - The UID of the message operated on.
  • operation - The operation performed, e.g., addKeywords or removeKeywords.
  • keywords - List of keywords added or removed from the message.
  • movedTo - The destination mailbox where the message was moved.
  • copiedTo - The destination mailbox where the message was copied.
  • result - Result of the move or copy operation.
  • deleted - Boolean indicating if the message was deleted.
  • unread - Boolean indicating if the message was marked as unread.

Dependencies

  • An IMAP server connection using credentials (host, port, secure, user, password)

Troubleshooting

  • Ensure the UID and mailbox names are correct and exist on the IMAP server to avoid errors.
  • If the destination mailbox does not exist and 'Create Destination If Missing' is false, move or copy operations will fail.
  • Message-ID must be provided for searchByMessageId operation; otherwise, an error is thrown.
  • Keywords must be provided for addKeywords and removeKeywords operations; missing keywords cause errors.
  • Network or authentication issues with the IMAP server can cause connection failures; verify credentials and server availability.

Discussion