Twilio allows you to purchase a toll-free phone number via Console or the REST API. We also allow users to port in an existing toll-free phone number. This guide will walk users through the steps for each method.
Notice: While Twilio has a wide range of available toll free phone numbers, we do not stock 1-800 prefix US-based numbers due to low availability.
Purchase a toll-free phone number via the Console GUI
- Access the Buy a Number page in Console.
- Click Show Advanced Search.
- Enter the criteria for the phone number you need, and then click Search.
- Country: Select the desired country from the drop-down menu.
- Number (Optional): Enter any desired prefix and number strings to start the phone number.
- Capabilities: Select your service needs for this number. Note - MMS is not supported on toll-free numbers.
- Type: Select Toll-Free.
- Address Requirement: Select the desired address requirement options.
- The search results will be displayed. Click Buy to purchase a phone number for your current project or sub-account.
Notice: Many countries require identity documentation for Phone Number compliance. Requests to provision phone numbers with these regulations will be required to select or add the required documentation after clicking Buy in Console. To see which countries and phone number types are affected by these requirements, please see our Phone Number Regulations site.
After your phone number has been successfully provisioned, your project will be charged for the full monthly price of the phone number. For more details, please see How much does a phone number cost.
Search for and Purchase a toll-free phone number via the REST API
Twilio phone numbers can also be searched and purchased programmatically using REST API requests.
First, users must make an HTTP GET request to the
AvailablePhoneNumberTollFree resource to find available phone numbers. Here’s an example cURL script:
curl -X GET https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/AvailablePhoneNumbers/US/TollFree.json \
Once the desired available toll-free phone number has been identified, users can provision it on their project or subaccount with an HTTP POST request to the
IncomingPhoneNumber resource. Here’s an example cURL script:
curl -X POST https://api.twilio.com/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/IncomingPhoneNumbers.json \
--data-urlencode "PhoneNumber=+1800XXXXXXX" \
--data-urlencode "AddressSid=ADXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
For more details, see Using the REST API to Search for and Buy Twilio Phone Numbers.
Port-in an existing toll-free phone number
Twilio may be able to port-in existing toll free phone numbers from other carriers. To get started, you’ll need request the phone number be ported in to Twilio via Console. For more information, see How do I submit a port request to Twilio.
Notice: Some services may offer expedited porting to Twilio through a Transfer to RespOrg option. To take advantage of expedited porting, please enter
TWI01 as the RespOrg.