SMTP (Email)
The SMTP connector sends email through your own SMTP server or relay. Messages can carry rows from the data pipeline as CSV, JSON or XLSX attachments.
When to use it
- A run sends an email: a digest, a failure alert or a file as an attachment.
- You send through an SMTP server or relay rather than an email API.
- The Human Approval node asks for its decision by email.
What you need
- The SMTP host and port, reachable from the runtime.
- A user name, and a password unless the relay authenticates by IP address.
- A sender address the server is allowed to send for.
Connect
The connection form lists its steps on the left. Open any step from that list. The Environments step holds the values that differ per environment.
Test connection is in the form footer. Beside it, Test against picks Base, the connection as saved, or an environment, whose values are applied first.
| Field | Step | What to enter |
|---|---|---|
| Username | Authentication | The SMTP user, often an email address. Required. |
| Password | Authentication | Optional, for a relay that authenticates by IP address. |
| SMTP Host | Connection | Such as smtp.example.com. Required. |
| Port | Connection | Usually 587 for STARTTLS, 465 for TLS and 25 for an internal relay. Required. |
| Use TLS/SSL | Connection | TLS from the first byte, usually port 465. |
| Require STARTTLS | Connection | Upgrade to TLS after connecting, usually port 587. |
| Disable TLS | Connection | Send without TLS. |
| Allow invalid TLS certificate | Connection | Accepts a self-signed or expired certificate. |
| From Email | Connection | Optional default sender for the node. |
| To Email | Connection | Optional default recipient for the node. |
| Connect Timeout (ms) | Options | Blank uses 8000. |
| Greeting Timeout (ms) | Options | Blank uses 8000. |
| Socket Timeout (ms) | Options | Blank uses 15000. |
| Notes | Options | Free text for your team. |
Set at most one of Use TLS/SSL, Require STARTTLS and Disable TLS.
Supported operations
Send Email works on a Notification node and on a Load node. Configure Action has these parts:
- Recipients: To, CC and BCC.
- Subject and Message, or a saved Email Template from Manage Account > Message Templates.
- Attachments: the node's rows as a file. Format is CSV, JSON or XLSX, with optional Compress (.gz). Split is Single file, One per row or Group by, and File Name Template names each file.
Limits
- Attachment size limits are set by your SMTP server and by the receiving system.
Troubleshooting
- Test connection passes and no mail arrives. The server accepted the message and a later system did not deliver it. Check the recipient address on the node, then the receiving system's spam handling.
- The server rejects the sender. Most relays accept only From addresses they are allowed to send for. Use an address on your own domain.
- TLS fails. Match the port to the mode: TLS/SSL and STARTTLS use different ports.
- The connection times out. The runtime cannot reach the server, or the port is blocked. Check firewall rules for the SMTP port.