Configure Custom External SMTP Email Provider

Before you start

• Provider must support LOGIN authentication.
• Provider must support TLS 1.2 or higher.
• Provider must have a certificate signed by a public certificate authority (CA).
• Configure your provider to allow inbound connections from Auth0. To see the list of required IP addresses, Public Cloud customers can navigate to Auth0 Dashboard > Branding > Email Provider. Private Cloud customers can contact Auth0 Support and request IPs specific to their instance.

When updating your SMTP email provider’s host, port, or username, you need to provide your SMTP email provider password. To learn more, read Deprecations and Migrations.

You can configure your own SMTP email provider to manage, monitor, and troubleshoot your email communications, and customize email templates.

When setting up a custom SMTP provider, Auth0 supports Basic Auth. Although as of October 1, 2022, Microsoft only supports “Modern Auth”, you can still use Basic Auth for SMTP authentication in your Auth0 configuration. If you are interested in Auth0 supporting “Modern Auth” for Office 365, please submit a feature request.

Configure custom SMTP server

1. Go to Auth0 Dashboard > Branding > Email Provider.
2. Enable the Use my own email provider toggle.
3. Select SMTP.
4. Enter a From email address, and then enter your SMTP server’s Host, Port, Username, and Password. Common ports include 25 and 587. Avoid using port 25 if possible, as many providers have limitations on this port.
5. Click Save.

Test email delivery

You can now send a test email using the Send Test Email button. If you have configured everything correctly, you will receive a confirmation email. If you do not receive an email after a few minutes, please check your Auth0 logs for any failures.

SMTP makes it easy to set up test services that allow you to test that your setup is working without spamming your users. To learn more, see Set Up Test SMTP Servers.

Learn more

• Configure External SMTP Email Providers