IMAP icon

IMAP

Retrieve emails via IMAP

Actions13

Mailbox → Get Status

AI-generated

Overview

This node operation retrieves the status of a specified mailbox via IMAP. It connects to the IMAP server using provided credentials, selects the mailbox, and fetches status information such as message counts and mailbox flags. This is useful for monitoring mailbox state, checking for new messages, or managing mailbox metadata in automated workflows.

Use Case Examples

  1. Check the number of unread emails in the INBOX to trigger notifications.
  2. Monitor mailbox status to automate email processing based on mailbox conditions.

Properties

Name Meaning
Credential Type Selects which credentials to use for IMAP authentication, either from this node or from an existing N8N IMAP Trigger node.
Mailbox Specifies the mailbox path to get the status for. Can be selected from a list or entered as a full path.

Output

JSON

  • messages
    • total - Total number of messages in the mailbox.
    • new - Number of new messages in the mailbox.
    • unseen - Number of unseen (unread) messages.
  • uidvalidity - Unique identifier validity value for the mailbox.
  • flags - List of flags set on the mailbox.

Dependencies

  • IMAP server credentials (either node-specific or shared from N8N IMAP Trigger node)

Troubleshooting

  • Connection failures due to incorrect credentials or network issues. Verify credentials and network access to the IMAP server.
  • Errors indicating unknown operation or resource usually mean a misconfiguration in the node parameters; ensure 'Mailbox' resource and 'Get Status' operation are selected.
  • If the node returns no data, check that the mailbox path is correct and the mailbox exists on the server.
  • IMAP connection errors might require checking server availability and credentials validity.

Discussion