Objective

Users who have two-factor authentication (2FA) enabled on their Twilio account via SMS or voice calls are able to change their contact phone number from Twilio Console at any time. This guide walks you through the process.

Notice: 2FA is a required security feature for all paid Twilio accounts, and can only be disabled on free trial accounts. For full details, see Enable Two-Factor Authentication on your Twilio Account.

Procedure

1. Access the User Settings page in the right top corner of the Console, by clicking your name.
2. Verification code sent to your email address is required to access the user setting page. Once you receive the code, please enter the code and click “Verify”.
   
3. Go to the “Two-factor authentication (2FA)” section and click “Edit”.
   
4. Click Reset next to the phone number.
   Note: If no phone number is listed, skip to Step 5.
    
5. Read the pop up text and select the checkbox then click Reset and continue.
   
6. Click + Add phone based verification.
   
7. Enter the desired phone number for use with two-factor authentication, and then click Send code via SMS.
   NOTE: We do not allow using a non-Twilio phone number for 2FA, otherwise users may be unable to access their account in the case of a suspension.
    
8. Enter the two-factor authentication code you received, and then click Verify.
   Note: Click Receive a call if you would rather receive an automated call with the authentication code.
    
9. An emergency recovery recovery code will be displayed; please make a note of it. When you’re ready to complete this process, click Finish and continue to the dashboard.
    

Reset your 2FA via web form

If you are an owner of an upgraded Twilio account (pay as you go with credit card or Paypal), you can now reset your 2FA via a web form, after login, by clicking on the Reset MFA link in the below screen:

You will be asked to verify your Twilio account information in order to complete the reset process.

Reset a Managed User's 2FA

If you are an Admin/Owner of an Organization and want to reset the 2FA of a Managed User, follow the below instructions:

1. Go to and click on Reset 2FA, then confirm the action.
2. This will remove the current 2FA number of the user and on their next login they will be prompted to enter a new one. The user will also receive an email notifying them of the reset of their 2FA number.