SMTP
Overview
info
Superblocks also has a native email integration that sends emails from Superblocks with no additional setup.
Send emails directly from an API step in an Application, Workflow, or Scheduled Job via your SMTP server.
Setting up SMTP
1. Add integration
Select SMTP from the integrations page.
2. Configure settings
Fill out the form with the following settings:
| Setting | Required | Description |
|---|---|---|
| Name | TRUE | Name that will be displayed to users when selecting this integration in Superblocks |
| Host | TRUE | Hostname or IP address to connect to |
| Port | TRUE | Port to use when connecting to SMTP |
| Username | TRUE | Username to use to connect |
| Password | TRUE | Password for username |
| Enable TLS | FALSE | Connect via TLS if selected. In most cases set this value to true if you are connecting to port 465. For port 587 or 25 keep it false. |
3. Test and save
Click Test Connection to check that Superblocks can connect to the server.
info
If using Superblocks Cloud, add these Superblocks IPs to your allowlist (not necessary for On-Premise-Agent).
After connecting successfully, click Create to save the integration.
4. Set profiles
Optionally, configure different profiles for separate development environments.
success
SMTP connected Now you can use SMTP in any Application, Workflow, or Scheduled Job.
Creating SMTP steps
To add an SMTP step to an API, choose "SMTP" as a new API step. Add the recipients email(s) in the To, Cc, and Bcc fields, along with the Subject. The Body field accepts both plain text and HTML. The From field can be updated to change the name, but the email will always be based on the integration's configuration.
You can optionally attach a list of files to send with the email by using the File Attachments Object Array with the format: [{name: <name_of_first_file>, contents: <contents_to_attach>, type: <file_type>}].
info
See our guide for sending spreadsheet files via email.