Actions9
Overview
This node connects to an IMAP server to manage emails and mailboxes. Specifically, the "Create Folder" operation allows users to create a new mailbox folder on their email server. This is useful for organizing emails into custom folders directly from an automated workflow.
Practical examples include:
- Automatically creating project-specific folders when new projects start.
- Organizing incoming emails by creating folders based on certain criteria or triggers.
- Setting up mailbox structure programmatically during onboarding processes.
Properties
| Name | Meaning |
|---|---|
| Folder Name | The name of the folder to create on the IMAP server |
Output
The output is an array of JSON objects representing the result of the operation. For the "Create Folder" operation, the output typically contains information about the newly created folder or confirmation of success. If multiple items are processed, the output will be an array of such JSON objects.
If an error occurs and the node is configured to continue on failure, the output will contain JSON objects with an error field describing the issue.
No binary data output is produced by this operation.
Dependencies
- Requires connection to an IMAP server with valid credentials (host, port, username, password).
- Needs an API key credential or authentication token for the IMAP server.
- Uses the
imapflowlibrary internally to handle IMAP protocol communication. - Network access to the IMAP server must be available from the n8n environment.
Troubleshooting
- Connection errors: Ensure the IMAP server details (host, port, security settings) and credentials are correct. Verify network connectivity.
- Timeouts during logout: The node attempts to logout gracefully but falls back to force closing the connection if logout times out after 5 seconds.
- Folder creation failures: Common reasons include insufficient permissions or folder name conflicts. Check the IMAP server's folder naming rules and user permissions.
- Error messages in output: If the node is set to continue on fail, errors will appear in the output JSON under the
errorkey. Review these messages to diagnose issues.
Links and References
- IMAP RFC 3501 – Protocol specification for IMAP.
- imapflow GitHub repository – The underlying IMAP client library used.
- n8n Documentation - IMAP Node – Official documentation for the IMAP node in n8n.