Before you start

If you use Passwordless SMS authentication, MFA SMS and voice notifications, or Phone as ID, you need to configure a phone provider with the Unified Phone Experience.If you need different providers for MFA, Passwordless, and/or Phone as ID, you must configure a custom phone provider using Auth0 Actions.
The Unified Phone Experience centralizes all phone provider configurations in one location in your tenant. This centralization eliminates the need to configure a phone provider multiple times for various phone authentication factors. If you want to try out phone messaging capabilities, you need to configure a tenant-level phone provider.
Auth0 does not provide feedback to the end user on whether a phone message has been sent successfully with the tenant-level provider. To troubleshoot issues, review the tenant logs.

​
Configure MFA

You can use the Unified Phone Experience with SMS, Voice, and SMS + Voice delivery methods and factors. To learn more about with Auth0, read Multi-Factor Authentication.
  1. In the Auth0 Dashboard, navigate to Branding > Phone Provider.
  2. Enable the Phone Message Provider toggle.
    Auth0 Dashboard > Branding > Phone Provider > Enable Phone Message Provider
  3. Select your phone message provider.
    1. To use Twilio as your phone provider, follow Configure Twilio as a Phone Messaging Provider.
    2. To use a custom provider, follow Configure a Custom Phone Provider to use Auth0 Actions.
  4. Select your delivery method(s).
    Desired MFA factors must be a subset of the delivery methods you configure at the tenant-level.
  5. Save your changes.
  6. Once complete, navigate to Security > Multi-factor Auth.
  7. Select Phone Message.
  8. Choose the authentication factors.
  9. Save your changes.

​
Configure Passwordless

You can use the Unified Phone Experience with a SMS connection. To learn more about passwordless authentication with Auth0, read Passwordless Connections.
  1. In the Auth0 Dashboard, navigate to Branding > Phone Provider.
  2. Enable the Phone Message Provider toggle.
    Auth0 Dashboard > Branding > Phone Provider > Enable Phone Message Provider
  3. Select your phone message provider.
    1. To use Twilio as your phone provider, follow Configure Twilio as a Phone Messaging Provider.
    2. To use a custom provider, follow follow Configure a Custom Phone Provider to use Auth0 Actions.
  4. Select your delivery method.
    If you do not select Text as a configured delivery method, your integration with Passwordless will not work.
  5. Save your changes.
  6. Once complete, navigate to Authentication > Passwordless > SMS.
  7. Save your changes.
  8. If you are using Twilio:
    1. Navigate to Applications > Applications.
    2. Select the application(s) you want to use for your Twilio SMS connection for Passwordless.
    3. Under Connections, enable the SMS (Twilio) option.
    4. Return to Authentication > Passwordless > SMS.
    5. Under the Applications tab, enable all applications you want to use for Passwordless SMS.
    6. Save your changes.
If you have a use case in need of the legacy MFA and Passwordless experience, contact Auth0 Support.

​
Test your phone provider

Test the tenant-level provider before using it in a production environment:
  1. Navigate to Branding > Phone Provider.
  2. Select Send Test Message to test the tenant-level provider before using it in a production environment.

​
Configure phone templates

The tenant-level phone provider uses Liquid syntax to inject contextual variables into your phone message content. To configure your phone templates, follow the instructions in Customize Phone Templates.

​
Disable phone provider

If you configure the Unified Phone Experience and then disable it, existing integrations with your phone provider could break, including your MFA phone factor.