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 project before it can be used for outbound call or SMS testing with a free trial account. We also allow verified phone numbers to be used as a caller ID on outbound calls (this feature not available for outbound messaging). Continue reading for instructions and important information.
Notice: Verified phone numbers can only be used as a Caller ID for outbound Twilio calls. 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.
Add a Verified Phone Number via Console
Notice: Free trial projects are only allowed to add verified caller IDs via SMS.
- Access the Verified Caller IDs page in Console.
- Click the red + sign icon , or Verify a number.
- Enter the desired phone number to verify, and then click Call Me.
NOTE: Click Text you instead to receive a text message for verification.
Add a Verified Phone Number via the REST API
A verified phone number can be added to your project 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.