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, named IMAP Manager, allows managing 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. 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. Move an email with a specific UID from the INBOX to an Archive folder.
  2. Add custom keywords to an email to categorize it for follow-up.
  3. Search for emails by their RFC822 Message-ID to find specific messages across mailboxes.

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 to move or copy the email message to.
Create Destination If Missing If true, the node will create the destination mailbox if it does not exist before moving or copying the message.

Output

JSON

  • mailbox - The mailbox/folder involved in the operation.
  • uid - The unique identifier of the email message involved in the operation.
  • operation - The type of operation performed (e.g., move, copy, addKeywords, removeKeywords).
  • messageId - The RFC822 Message-ID used in search operations.
  • uids - Array of UIDs found by searching with a Message-ID.
  • movedTo - The destination mailbox where the message was moved.
  • copiedTo - The destination mailbox where the message was copied.
  • result - The result of the move or copy operation, indicating success or failure.
  • deleted - Boolean indicating if the message was deleted.
  • unread - Boolean indicating if the message was marked as unread.
  • keywords - Array of keywords added or removed from the message.

Dependencies

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

Troubleshooting

  • Ensure the UID and mailbox names are correct and exist on the IMAP server to avoid errors.
  • If moving or copying messages to a mailbox that does not exist, enable 'Create Destination If Missing' to automatically create it.
  • Errors related to missing parameters like UID or messageId will be thrown if these are not provided.
  • Connection issues may arise if IMAP credentials are incorrect or the server is unreachable.

Discussion