Skip to main content
Version: 3.0.0-LTS

SMTP Configuration

Available on: Paid plans

ToolJet uses SMTP (Simple Mail Transfer Protocol) to send emails for various purposes, including invitations and password reset requests. This guide will walk you through the process of configuring SMTP settings in ToolJet.

Prerequisites

Before you begin, ensure you have:

  • Admin access to ToolJet
  • SMTP server details from your email service provider
info

If you have upgraded from a version prior to v2.62.0, the SMTP variables in your .env file will automatically be mapped to the UI.

Configuration Without Environment Variables

  1. Navigate to the Settings section in ToolJet.
  2. Select the Email protocol (SMTP) tab.
  3. Toggle the switch to enable Email protocol (SMTP).
  4. Configure the following fields:
FieldDescriptionExample
HostSMTP server hostnamesmtp.gmail.com
PortSMTP server port number587
UserSMTP account username[email protected]/b2313d02f4f4jb
PasswordSMTP account passworda13d0sd344
Sender's emailEmail address of the sender[email protected]
SMTP     Configuration Without Environment Variables
  1. Click Save changes to apply the new SMTP configuration.

Configuration With Environment Variables

ToolJet allows you to configure SMTP settings using environment variables. You can enable a toggle in the Email protocol (SMTP) settings to apply or fetch the configuration directly from your .env file.

SMTP Configuration Without Environment Variables

Example Environment Variables:

DEFAULT_FROM_EMAIL=hello@tooljet.io
SMTP_USERNAME=your-username
SMTP_PASSWORD=your-password
SMTP_DOMAIN=smtp.mailgun.org
SMTP_PORT=587
SMTP_SSL=false
SMTP_DISABLED=false
  • For new installations, if SMTP is configured in the .env file, the Apply configuration from environment variables toggle will be turned on by default. If not, it will be turned off by default.
  • When the toggle is enabled, the SMTP settings fields in the UI will be populated with values from the environment variables and will be read-only.
  • Disabling the toggle allows you to manually enter or edit SMTP settings directly in the UI.

Commonly Used Email Providers

Here are some general settings for the most commonly used email providers:

ProviderHostPortUsernamePasswordSender's email
Gmailsmtp.gmail.com587 or 465 (SSL)EmailPasswordEmail
Yahoo Mailsmtp.mail.yahoo.com465 (SSL)EmailPasswordEmail
Outlook.com/Hotmailsmtp.office365.com587 or 465 (SSL)EmailPasswordEmail
Zoho Mailsmtp.zoho.com587 or 465 (SSL)EmailPasswordEmail
SendGridsmtp.sendgrid.net587 or 465 (SSL)apikeyAPI keyEmail
Mailgunsmtp.mailgun.org587 or 465 (SSL)SMTP usernamePasswordEmail
info

For SendGrid and Mailgun, the sender's email can be different from the username, subject to the provider's verification requirements. The username for SendGrid is apikey, and the password is your API key. For Mailgun, you usually use a specific SMTP username and password provided by Mailgun, not your regular email credentials.