SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site, support.twilio.com, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to help.twilio.com, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

How to Add and Remove a Verified Phone Number or Caller ID with Twilio

An existing non-Twilio phone number, like the number to a wireless phone or a landline in your home or office, must be validated on your Twilio account, via a One-time-passcode (OTP), before it can be used for specific Twilio account services.

  • For free trial accounts you will only be able to make calls or send SMS from your free trial account to numbers that are verified caller IDs on the account. Additionally, you will only be able to receive inbound calls from numbers that are verified caller IDs on the account. We allow verified phone numbers to be used as a caller ID on outbound calls for trial accounts as well.
  • For upgraded accounts we allow verified phone numbers to be used as a caller ID on outbound calls (this feature not available for outbound messaging). 

NOTE: Verified Caller IDs cannot be used as the display name on outgoing SMS or MMS message. Verified Caller IDs are intended to be used with voice services only.

While a verified phone number can be used as a Caller ID for outbound Twilio calls, you will not be able to receive inbound calls to Twilio over this number. Incoming calls to the verified number will continue to route through the existing service provider (your wireless service, landline provider, etc.). If you would like to receive incoming calls through Twilio, you may be able to forward your calls to a Twilio phone number via your service provider. Alternatively, we may be able to port your phone number in. For more information, please see our article Porting a Phone Number to Twilio.

Table of Contents

Add a Verified Phone Number via Console

Notice: Verified Caller IDs is only available for US1 region at this time. It is not available for IE1 or AU1 regions. Please see Regional product availability for more information on region specific services.

Notice: Free trial projects are only allowed to add verified caller IDs via SMS.

 

  1. Access the Verified Caller IDs page in Console.
  2. Click Add a new Caller ID addCallerID_01_113px.png.
  3. Enter the desired phone number to verify, select the desired verification method, and then click Verify Number.
    Screenshot_2023-01-26_at_11.36.07_AM.png 

Add a Verified Phone Number via the REST API

A verified phone number can be added to your account by submitting an HTTP POST request to the OutgoingCallerIds REST API resource. For full details, please see Add an Outgoing Caller ID (Twilio Docs).

Verifying Phone Numbers Behind an IVR or Extension

You can verify numbers behind IVRs using both the above methods by including w characters in the Extension parameter. Each w character tells Twilio to wait 0.5 seconds instead of playing a digit. This lets you adjust the timing of when the digits begin playing to suit the phone system you are dialing.

For example, the extension wwww2wwwwww5wwwwww9 waits two seconds before sending the digit 2, followed by a three second wait before sending the 5, and finally another three second wait before sending a 9. You will need to tune the extension to the IVR system to be able to programmatically verify numbers behind IVR menus.

Verifying Phone Numbers at Scale

If you have a large number of phone numbers that you need to verify programmatically, please see this guide here: Verifying Caller IDs at Scale.

Remove a Verified Phone Number via Console

  1. Access the Verified Caller IDs page in Console.
  2. Locate the desired phone number to remove.
  3. To remove a Verified Caller ID, click RemoveScreenshot_2023-01-26_at_11.15.55_AM.png

Additional Resources

Have more questions? Submit a request
Powered by Zendesk