Connect to SMTP servers
Learn how to connect an SMTP server to Retool.
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.
Requirements
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.
| Setting | Required | Description |
|---|---|---|
| Host | Yes | The host name or IP address. |
| Port | Yes | The connection port. |
| Username | No | The username for authentication. |
| Password | No | The 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.
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.
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.
Wrap up
Your SMTP resource is now ready to use. To send emails with Retool, select the newly added resource in the query editor.
Updated 23 days ago