SMTP Step

The SMTP step sends an email through a configured SMTP server using a named connection. Use it when your organization manages its own mail infrastructure or needs to deliver messages from a specific domain rather than a third-party email service.

Configuration

name	type	required	description
`connection`	string	yes	The name of the SMTP connection to use, as configured in Integrations.
`action`	string	yes	The operation to perform. Must be `SEND_EMAIL`.
`sendFrom`	string	yes	The sender email address.
`sendTo`	string	yes	The recipient email address. Supports mapping placeholders.
`subject`	string	yes	The email subject line. Supports mapping placeholders.
`message`	string	yes	The email body content. Supports mapping placeholders.
`attachments`	array	no	Optional file attachments. See Attachments below.

Attachments

Each entry in the attachments array defines a file to include in the email.

name	type	required	description
`source`	string or object	yes	The file to attach. Accepts an object with `id` and `downloadUrl`, a generated file descriptor with `name` and optional `metadata`, or a plain string URL. See the Amazon S3 step for full source format details.
`name`	string	yes	The file name to use as the attachment name in the email.

Example

Here's a minimal configuration that sends an email with a single PDF attachment.

{
  "connection": "smtp-prod",
  "action": "SEND_EMAIL",
  "sendFrom": "[email protected]",
  "sendTo": "[email protected]",
  "subject": "Invoice",
  "message": "Please find your invoice attached.",
  "attachments": [
    {
      "source": {
        "id": "file-777",
        "downloadUrl": "https://files.example.com/download/file-777"
      },
      "name": "invoice.pdf"
    }
  ]
}