Examples

Example 1: Basic Unread Email Trigger

Scenario: Fire a workflow for every new unread email arriving in the support mailbox. Create a CRM ticket from the email subject and body. This is the minimal configuration for an email-to-ticket workflow.

{
  "Host": "imap.gmail.com",
  "Port": 993,
  "User": "support@mycompany.com",
  "Password": "{{ secrets.SUPPORT_IMAP_PASSWORD }}",
  "Tls": true,
  "Mailbox": "INBOX",
  "CustomEmailConfig": ["UNSEEN"],
  "Format": "simple",
  "DownloadAttachments": false,
  "PostProcessAction": "read",
  "BatchSize": 20
}

Example 2: Filter by Sender and Date Range

Scenario: An accounts payable workflow should only trigger on invoices from a specific supplier email domain, received within the current month. All other emails in the INBOX should be ignored by this trigger.

{
  "Host": "outlook.office365.com",
  "Port": 993,
  "User": "accounts@mycompany.com",
  "Password": "{{ secrets.ACCOUNTS_IMAP_PASSWORD }}",
  "Tls": true,
  "Mailbox": "INBOX",
  "CustomEmailConfig": [
    "UNSEEN",
    "FROM", "billing@vendorcorp.com",
    "SINCE", "01-May-2026"
  ],
  "Format": "resolved",
  "DownloadAttachments": false,
  "PostProcessAction": "read",
  "BatchSize": 10
}

Example 3: Download and Process Email Attachments

Scenario: An invoice processing workflow triggers on emails with attachments from any supplier, downloads the PDF attachments, and routes them to a FlowRag node for AI data extraction.

{
  "Host": "imap.gmail.com",
  "Port": 993,
  "User": "invoices@mycompany.com",
  "Password": "{{ secrets.INVOICES_IMAP_PASSWORD }}",
  "Tls": true,
  "Mailbox": "INBOX",
  "CustomEmailConfig": ["UNSEEN"],
  "Format": "simple",
  "DownloadAttachments": true,
  "AttachmentsBinaryPropertyPrefix": "invoice_attachment_",
  "PostProcessAction": "read",
  "BatchSize": 5
}

Example 4: Delete Emails After Processing

Scenario: A compliance mailbox receives notification emails from a third-party system. After each email is processed and its data extracted to a compliance database, the email is no longer needed and should be removed from the mailbox to prevent accumulation.

{
  "Host": "mail.mycompany.com",
  "Port": 993,
  "User": "compliance-notify@mycompany.com",
  "Password": "{{ secrets.COMPLIANCE_IMAP_PASSWORD }}",
  "Tls": true,
  "AllowUnauthorizedCerts": false,
  "Mailbox": "INBOX",
  "CustomEmailConfig": ["UNSEEN", "FROM", "notify@thirdpartysystem.com"],
  "Format": "simple",
  "DownloadAttachments": false,
  "PostProcessAction": "delete",
  "BatchSize": 50,
  "CommandTimeoutSeconds": 60
}

Example 5: Parse CSV Attachment with CodeExecute

Scenario: A sales operations workflow receives a daily email from a partner system with a CSV file containing new lead data. The IMAP Trigger downloads the CSV, and a CodeExecute node parses it into structured records for CRM import.

{
  "Host": "imap.gmail.com",
  "Port": 993,
  "User": "leads@mycompany.com",
  "Password": "{{ secrets.LEADS_IMAP_PASSWORD }}",
  "Tls": true,
  "Mailbox": "INBOX",
  "CustomEmailConfig": [
    "UNSEEN",
    "FROM", "exports@partnersystem.com",
    "SUBJECT", "Daily Lead Export"
  ],
  "Format": "simple",
  "DownloadAttachments": true,
  "AttachmentsBinaryPropertyPrefix": "csv_",
  "PostProcessAction": "read",
  "BatchSize": 3
}

// Access the attachment info to get the binary key
const attachments = input.nodes.imapTrigger.output.attachments;
const csvAttachment = attachments.find(a => a.MimeType === "text/csv" || a.FileName.endsWith(".csv"));

if (!csvAttachment) {
  throw new Error("No CSV attachment found in email: " + input.nodes.imapTrigger.output.subject);
}

// The binary field key is stored in csvAttachment.BinaryKey (e.g. "csv_0")
const binaryKey = csvAttachment.BinaryKey;
const csvBuffer = input.binary[binaryKey];

// Decode the binary buffer to a UTF-8 string
const csvText = Buffer.from(csvBuffer.data, "base64").toString("utf8");

// Parse CSV lines into records
const lines = csvText.trim().split("\n");
const headers = lines[0].split(",").map(h => h.trim().replace(/^"|"$/g, ""));

const records = lines.slice(1).map(line => {
  const values = line.split(",").map(v => v.trim().replace(/^"|"$/g, ""));
  const record = {};
  headers.forEach((h, i) => { record[h] = values[i] || ""; });
  return record;
});

return {
  leadCount: records.length,
  leads: records,
  sourceEmail: input.nodes.imapTrigger.output.from,
  receivedDate: input.nodes.imapTrigger.output.date
};