If we support your email provider directly, we recommend using that integration (instead of SMTP server details) because it supports more secure authentication protocols.
SMTP server requirements
The SMTP server must:- Support SMTP AUTH with the LOGIN protocol.
- Support TLS 1.2 or higher.
- Have a certificate signed by a public certificate authority (CA).
- Allow inbound connections from Auth0 IP addresses.
Configure tenants with an SMTP server
You can configure your tenant with an SMTP server using the Auth0 Dashboard or using the Management API.Using the Auth0 Dashboard
To configure your tenant with an SMTP server using the Auth0 Dashboard:- Go to Auth0 Dashboard > Branding > Email Provider.
- Enable the Use my own email provider toggle.
- Select SMTP.
- Enter a From email address, and then enter your SMTP server’s Host, Port, Username, and Password. We recommend port 587 if available because it is the current default SMTP port and supports TLS. Some providers may require use of the older port 465. We recommend against port 25, the original SMTP port, because it is blocked by many providers and ISPs.
- Click Save.
Using the Management API
To configure your tenant with an SMTP server using the Management API, use the/api/v2/emails/provider endpoint.
-
To configure an email provider for the first time, send a
POSTrequest to/api/v2/emails/provider. -
To update an existing email provider, send a
PATCHrequest to/api/v2/emails/provider. When changing the host, port, or username, you must supply a password.
Additional considerations
- If you need support for authentication protocols other than LOGIN, you can write an Action to connect to your SMTP server.
-
In April 2026, Microsoft Exchange Online plans to retire basic authentication for SMTH AUTH, which affects the
smtp.office365.comandsmtp-legacy.office365.comendpoints. We recommend using our integrations for Microsoft Office 365 Exchange Online and Azure Communication Services Email.