Actions9
Overview
This node connects to an IMAP email server to manage emails and mailboxes. Specifically, the "Mark as Read/Unread" operation allows users to change the read status of a specific email within a chosen folder. This is useful for automating email workflows, such as marking important messages as read after processing or flagging unread emails for follow-up.
Practical examples:
- Automatically mark notification emails as read once processed by another workflow.
- Reset the read status of certain emails to unread to trigger manual review later.
Properties
| Name | Meaning |
|---|---|
| Folder | The email folder to work with. Can be selected from a list of folders or specified by name (e.g., INBOX). |
| Email UID | The unique identifier of the email to mark as read or unread. |
| Mark As | Whether to mark the email as "Read" or "Unread". |
Output
The output is an array of JSON objects representing the result of the operation. Each item corresponds to one input item processed. If successful, the JSON object contains details about the operation's outcome (structure depends on the underlying IMAP library response). In case of failure and if "Continue On Fail" is enabled, the output includes an error message under the error key.
No binary data is output by this operation.
Dependencies
- Requires connection credentials to an IMAP server: host, port, security settings, username, and password.
- Uses the
imapflowlibrary to interact with the IMAP server. - The node requires proper configuration of these credentials in n8n before use.
Troubleshooting
Common issues:
- Incorrect IMAP server credentials or connection details will cause authentication failures.
- Specifying an invalid folder or email UID may result in errors indicating the email cannot be found.
- Network timeouts or connectivity problems can interrupt operations.
Error messages:
- Authentication errors: Verify username, password, and server details.
- Timeout errors during logout or connection: Check network stability and server responsiveness.
- "Email not found" or similar: Confirm the folder and email UID are correct and accessible.
To resolve errors, ensure credentials are accurate, the target folder exists, and the email UID corresponds to an existing email.
Links and References
- IMAP Protocol Overview
- imapflow GitHub Repository - underlying library used for IMAP interactions