SWIRLS_
GuidesNodes

Email

Send email with dynamic content using placeholders for recipients, subjects, and body text.

Email nodes send an email message via the project's configured email provider. Use them to notify users, deliver reports, or send content generated by upstream nodes such as AI or Code.

Configuration

FieldTypeRequiredDescription
fromstringNoSender email address. Supports placeholders (for example, {{secrets.fromEmail}}).
tostringNoRecipient email address or addresses. Supports placeholders (for example, {{input.customerEmail}}).
subjectstringNoEmail subject line. Supports placeholders (for example, Report for {{input.date}}).
textstringNoPlain-text email body. Supports placeholders for dynamic content.
htmlstringNoHTML email body. Use when you need formatted content with links, images, or styling. Supports placeholders. When both text and html are provided, email clients that support HTML will display the HTML version.
replyTostringNoReply-To address. Optional. Supports placeholders.

Input

The node receives the trigger payload and upstream node outputs. Use placeholders in any configuration field to inject dynamic data -- for example, {{input.customerEmail}} in the to field or {{input.reportBody}} in the html field.

Output

The node produces a result indicating delivery status, typically including a message ID on success or an error on failure. This output is stored in the node execution record and can be passed to downstream nodes.

Tips

  • Store sender addresses and provider credentials in Secrets and reference them with placeholders. Never hardcode sensitive values.
  • Use text for simple notifications. Use html when you need links, formatting, or branded templates.
  • Validate recipient addresses upstream (for example, with a Code node) to avoid failed deliveries.
  • Email delivery behavior, rate limits, and sender verification requirements depend on the project's configured email provider.
  • Secrets -- Store email provider credentials and sender addresses.
  • AI -- Generate email content dynamically before sending.
  • Code -- Build or validate email fields before the email node runs.

On this page