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. 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 keywords to a designated folder.
  2. Search for emails by their Message-ID to retrieve their unique identifiers.
  3. Delete emails by UID from a specified mailbox.

Properties

Name Meaning
Mailbox The mailbox or 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 like addKeywords, removeKeywords, move, copy, delete, and markUnread.

Output

JSON

  • mailboxes - List of mailboxes with details such as path, name, flags, special use, delimiter, and listed status (for listMailboxes operation).
  • mailbox - The mailbox where the operation was performed.
  • messageId - The RFC822 Message-ID used for searching messages (for searchByMessageId operation).
  • 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 - Keywords (tags) added or removed from the message.
  • movedTo - Destination mailbox where the message was moved.
  • copiedTo - Destination mailbox where the message was copied.
  • result - Result of 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 with credentials (host, port, user, password, secure) is required.

Troubleshooting

  • Common errors include missing required parameters such as 'uid' or 'messageId'. Ensure these are provided for the respective operations.
  • Errors related to mailbox existence can occur when moving or copying messages; enabling 'Create Destination If Missing' can help resolve this by creating the mailbox automatically.
  • Connection issues may arise if IMAP credentials are incorrect or the server is unreachable.

Links

  • ImapFlow Library - The underlying IMAP client library used for managing IMAP operations.

Discussion