Configure Azure Communication Services as External SMTP Email Provider

Describes how to configure Azure Communication Services as an email provider.

Before you start

• Create a Microsoft Azure account.
• Configure your firewall to accept traffic from Auth0. For more information, read Auth0 IP Address for Allow List.

You can use Azure Communication Services as an external SMTP email provider for your Auth0 tenant to manage, monitor, and troubleshoot your outgoing messages.

Create a resource in Microsoft Azure

1. Log in to your Microsoft Azure account.
2. Create a Communication Servicesresource if you do not have one.
3. Enter “Communication Services” in the search bar.
4. Select Create.
5. Under the Tools settings, select Keys. Retrieve your Communication Services Connection String.
6. Under Primary Key, copy the Connection string value. A valid connection string follows the format endpoint=COMMUNICATION_SERVICES_URL;accesskey=ACCESS_KEY.

Configure your email provider in Auth0

1. Go to Dashboard > Branding > Email Provider.

2. Select Use my own email provider.

3. Select Azure Communication Services.

4. Enter a From email address.

   Azure Communications Services only supports a raw email address ([e-mail]) in the From field.

   Make sure you update the default value ({{ application.name }} <[e-mail]>) to avoid errors.

5. Add the Azure Communication Services Connection string.

6. Select Save.

Send a test email

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 error codes. The Communication Services Metrics Monitor page will now display delivery insights for all emails that have been sent to your users.