IMAP Manager icon

IMAP Manager

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

Actions8

Overview

This node, named IMAP Manager, allows users to manage emails on an IMAP server. It supports operations such as listing mailboxes, searching emails by Message-ID, adding or removing keywords (tags) to messages, moving or copying messages between mailboxes, deleting messages, and marking messages as unread by removing the Seen flag. This node is useful for automating email management tasks, such as organizing emails into folders, tagging important messages, or marking emails as unread for follow-up.

Use Case Examples

  1. Automatically move emails with specific keywords to a designated mailbox.
  2. Tag emails with custom keywords for categorization and later processing.
  3. Mark emails as unread to flag them for review.
  4. Search for emails by their Message-ID to retrieve specific messages.

Properties

Name Meaning
Mailbox The mailbox (folder) on the IMAP server where the operation will be performed. Defaults to INBOX.
UID The unique identifier of the email message to operate on. Required for operations that target specific messages, such as marking unread, moving, copying, deleting, or modifying keywords.

Output

JSON

  • mailbox - The mailbox involved in the operation.
  • uid - The unique identifier of the email message involved in the operation.
  • operation - The type of operation performed (e.g., addKeywords, removeKeywords).
  • keywords - The keywords added or removed from the message.
  • messageId - The RFC822 Message-ID used in search operations.
  • uids - Array of UIDs found by searching with the Message-ID.
  • movedTo - The destination mailbox where the message was moved.
  • copiedTo - The destination mailbox where the message was copied.
  • result - Result of move or copy operation.
  • deleted - Indicates if the message was deleted.
  • unread - Indicates if the message was marked as unread.
  • mailboxes - List of mailboxes returned by the list operation, filtered by optional substring.
  • path - Path of a mailbox in the list operation.
  • name - Name of a mailbox in the list operation.
  • flags - Flags associated with a mailbox.
  • specialUse - Special use attribute of a mailbox.
  • delimiter - Delimiter character used in mailbox paths.
  • listed - Indicates if the mailbox is listed.

Dependencies

  • An IMAP server and credentials (host, port, user, password, secure connection) are required to connect and perform operations.

Troubleshooting

  • Common errors include missing required parameters such as UID or Message-ID for specific operations. Ensure these are provided to avoid errors.
  • If the destination mailbox does not exist during move or copy operations and 'Create Destination If Missing' is enabled, the node attempts to create it. If creation fails, the operation may fail.
  • Connection issues to the IMAP server can cause failures; verify credentials and network connectivity.
  • Errors related to mailbox existence or permissions may occur; ensure the mailbox paths are correct and accessible.

Discussion