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: 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.
Add a Verified Phone Number via Console
- Login to your account at www.twilio.com/console.
- Click Phone Numbers .
- Click Verified Caller IDs.
- 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 POST request to the Outgoing Caller IDs resource. For full details, please see our API documentation for Adding an Outgoing Caller ID.
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.