Actions12
- Mailbox Actions
- Email Actions
Overview
This node interacts with an IMAP email server to perform various mailbox-related operations. Specifically, the Rename Mailbox operation allows users to rename an existing mailbox (folder) on their IMAP server.
Typical use cases include:
- Organizing mailboxes by renaming folders to more meaningful names.
- Automating mailbox management tasks in workflows, such as renaming a folder after processing emails.
- Synchronizing mailbox structures between different systems or services.
For example, you might rename a mailbox from "OldFolder" to "ArchivedEmails" automatically after moving all emails out of it.
Properties
| Name | Meaning |
|---|---|
| Credential Type | Choose which credentials to use for connecting to the IMAP server: - IMAP: Use credentials defined directly in this node. - N8N IMAP Trigger Node: Use existing credentials from an IMAP trigger node in the workflow. |
| Mailbox | Select the mailbox (folder) to rename. You can either: - Pick from a list of available mailboxes. - Enter the full path to the mailbox manually. This is required. |
| New Mailbox Name | The new name to assign to the selected mailbox. This is a required string input. |
Output
The node outputs JSON data representing the result of the rename operation. While the exact structure depends on the underlying IMAP library's response, typically it will confirm success or provide details about the renamed mailbox.
No binary data output is produced by this operation.
Dependencies
- Requires valid IMAP server credentials, either provided directly in the node or inherited from an existing IMAP trigger node.
- The node uses an IMAP client library internally to connect and perform mailbox operations.
- Environment variable
N8N_LOG_LEVELcan influence logging verbosity (e.g., setting it to "debug" enables detailed logs).
Troubleshooting
- Connection failed errors: Usually caused by incorrect credentials, wrong server address, or network issues. Verify your IMAP credentials and server accessibility.
- Unknown operation error: If the operation name does not match supported ones, ensure you have selected "Rename Mailbox" under the Mailbox resource.
- Permission denied or mailbox not found: The specified mailbox path may be incorrect or the user lacks permissions. Double-check the mailbox path and user rights on the IMAP server.
- Empty or no data returned: Indicates that the rename operation did not produce any output; verify if the mailbox exists and the new name is valid.
- General IMAP errors: The node captures and logs detailed IMAP errors. Review logs for specific messages and consult your IMAP server documentation.