> ## Documentation Index
> Fetch the complete documentation index at: https://docs-staging-quickstart-revamp.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Learn how to configure a custom external SMTP email provider.

# Configure Custom External SMTP Email Provider

<Card title="Before you start">
  * Provider must support LOGIN [authentication](https://en.wikipedia.org/wiki/SMTP_Authentication).
  * Provider must support [TLS 1.2](https://en.wikipedia.org/wiki/STARTTLS) or higher.
  * Provider must have a certificate signed by a public certificate authority (CA).
  * Configure your provider to [allow inbound connections from Auth0](/docs/secure/security-guidance/data-security/allowlist). To see the list of required IP addresses, Public Cloud customers can navigate to [Auth0 Dashboard > Branding > Email Provider](https://manage.auth0.com/#/templates/provider). Private Cloud customers can contact [Auth0 Support](https://support.auth0.com) and request IPs specific to their instance.
</Card>

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  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](/docs/troubleshoot/product-lifecycle/deprecations-and-migrations).
</Callout>

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

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  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](https://auth0.com/feedback).
</Callout>

## Configure custom SMTP server

1. Go to [Auth0 Dashboard > Branding > Email Provider](https://manage.auth0.com/#/templates/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](https://manage.auth0.com/#/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](/docs/customize/email/configure-test-smtp-email-servers).

## Learn more

* [Configure External SMTP Email Providers](/docs/customize/email/smtp-email-providers)
