sendEmail Documentation

Overview

The sendEmail workflow node sends emails containing workflow output data to specified recipients. Emails are dispatched from noreply@intuidy.com using Amazon SES (Simple Email Service). The node supports both single execution (one email with all data) and batch execution (one email per data row when connected to a Bulk Mapping node).

Settings

1. to (Recipient Emails)

• Input Type: String (comma-separated)
• Description: One or more recipient email addresses. Maximum 50 recipients per execution.
• Variable Support: When used with Bulk Mapping, supports {{column_name}} syntax for per-row recipient resolution.
• Default: Required — omitting causes an error.

2. subject

• Input Type: String
• Description: Email subject line.
• Variable Support: Supports {{column_name}} for dynamic per-row subjects.
• Default: "Workflow Output"

3. bodyTemplate

• Input Type: String (optional)
• Description: Custom email body. If omitted, input data is auto-formatted into a summary table using smart formatting. Supports {{column_name}} variable syntax.
• Default: None (auto-format mode)

4. bodyFormat

• Input Type: Dropdown (html | text)
• Description: Controls whether the body is rendered as HTML or plain text. HTML content is sent as-is within the Vantage email template. Plain text is wrapped in the template.
• Default: "text" (HTML if custom template detected)

How It Works

Single Execution (Standard)

1. Receives input data from inputs.input1
2. Parses and validates recipient email addresses
3. Generates the email body from the custom template or auto-formats the input data
4. Sends the email via the internal sendWorkflowEmail service
5. Returns a success report with email details

Batch Execution (with Bulk Mapping)

When connected downstream of a Bulk Mapping node:

1. The Bulk Mapping node iterates over each selected row
2. For each row, {{column_name}} variables in To, Subject, and Body are resolved with that row's values
3. An individual email is sent per row
4. Errors on individual rows don't stop the batch

Variable Syntax

Data Expectations

• inputs.input1: The data payload to include in the email. Can be JSON objects, arrays, strings, or structured data.
• Recipient validation: Email addresses are parsed, trimmed, and validated. Invalid or empty addresses cause errors.
• Maximum recipients: 50 per execution (single mode) or per-row (batch mode).

Email Delivery

• Sender: noreply@intuidy.com
• Service: Amazon SES
• Template: All emails use the Vantage branded email template
• Rate limits: Subject to SES sending rate limits

Use Cases

1. Batch Customer Notifications

Connect: Database Query → Bulk Mapping → Send Email Map email to recipient, use {{customer_name}} in subject and body template for personalized notifications.

2. Automated Report Delivery

Connect: Data Transform → Send Email Auto-format workflow results as a summary table and email to a distribution list.

3. Alert Emails

Connect: Event Monitor → Conditional → Send Email Trigger alert emails when workflow conditions are met.

Example Configuration

{
  "config": {
    "to": "{{email_address}}",
    "subject": "Order {{order_id}} Confirmation",
    "bodyTemplate": "Hello {{first_name}},\n\nYour order {{order_id}} has been confirmed.\n\nTotal: ${{total}}",
    "bodyFormat": "text"
  }
}