Skip to main content

Connect to SMTP servers

You can connect an SMTP server and make it available as a resource in Retool. Once complete, your users can write queries that interact with SMTP data.


To add an SMTP server as a resource, you need:

  • Sufficient user permissions to add resources.
  • Configuration settings for the SMTP server.

User permissions

All users for Retool organizations on Free or Team plans have global Edit permissions and can add, edit, and remove resources.

For organizations subscribed to the Business or Enterprise plan that manages user permissions, you must be a member of a group with Edit all permissions for resources.

Configuration settings

You must provide the following settings to connect an SMTP server to Retool.

HostYesThe host name or IP address.
PortYesThe connection port.
UsernameNoThe username for authentication.
PasswordNoThe password for authentication.

1. Create a new resource

Sign in to your Retool organization and select the Resources tab, then click Create new > Resource. Retool provides built-in integrations for a variety of popular data sources to get started quickly, including SMTP. Select the SMTP integration to start configuring the new resource.

Select the resource

2. Configure SMTP resource settings

Set the name and folder for the new SMTP resource. Use a descriptive name to distinguish between other SMTP resources you may use. Retool displays the name and the resource type in query editors to help users identify them.

Configure all required settings for the SMTP server to provide Retool with access to your data source. You may need to configure optional settings if the SMTP server requires them.

Configure settings

Click Test Connection to verify that Retool can connect to the SMTP server with the provided credentials. If the test fails, check your credentials and try again. Testing a connection only checks whether Retool can successfully connect to the resource. It cannot check whether the provided credentials have sufficient privileges or can perform every supported action.

3. Save the resource

Once finished, click Create resource to complete the setup. You can click Create app to start building a new Retool app or Back to resources to return back to the Resources tab.

Resource created

Wrap up

Your SMTP resource is now ready to use. To send emails with Retool, select the resource in the query editor.