IMAP icon

IMAP

Retrieve emails via IMAP

Overview

This node operation downloads attachments from emails accessed via IMAP. It supports downloading all attachments or specific attachments by their part IDs from a specified mailbox and email UID. It can also include inline attachments if desired. This is useful for automating the retrieval of email attachments for processing, storage, or further workflow automation, such as saving invoices, reports, or media files received via email.

Use Case Examples

  1. Download all attachments from an email in the INBOX mailbox.
  2. Download specific attachments by part IDs from a particular email.
  3. Include inline images embedded in HTML emails when downloading attachments.

Properties

Name Meaning
Credential Type Selects which IMAP credentials to use for connecting to the email server.
Mailbox The mailbox path to select the folder containing the email.
Email UID The unique identifier of the email from which to download attachments.
All Attachments Whether to download all attachments from the email.
Attachment Part IDs Comma-separated list of specific attachment part IDs to download when not downloading all attachments.
Include Inline Attachments Whether to include inline attachments such as images embedded in the HTML body when downloading all attachments.

Output

JSON

  • attachmentData - The downloaded attachment data, typically including file content and metadata.
  • attachmentInfo - Information about the attachments downloaded, such as part IDs and filenames.

Dependencies

  • IMAP server credentials (either node-specific or from an IMAP trigger node)

Troubleshooting

  • Connection failures due to incorrect IMAP credentials or server settings. Verify credentials and server details.
  • Errors related to invalid email UID or mailbox path. Ensure the email UID and mailbox path are correct and accessible.
  • Issues with specifying attachment part IDs incorrectly. Use the 'attachmentsInfo' property from the email to find correct part IDs.
  • Timeouts or disconnections during attachment download. Check network stability and IMAP server responsiveness.

Discussion