Skip to main content
SMTP logo




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:

NameTRUEName that will be displayed to users when selecting this integration in Superblocks
HostTRUEHostname or IP address to connect to
PortTRUEPort to use when connecting to SMTP
UsernameTRUEUsername to use to connect
PasswordTRUEPassword for username
Enable TLSFALSEConnect 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.


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.


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>}].


See our guide for sending spreadsheet files via email.