A2P 10DLC Campaign Vetting Delays: We are experiencing delays while vetting 10DLC campaigns. Our third party is reviewing campaigns manually, and due to the high volume of requests, a queue has built up. Campaign reviews are expected to take longer. Twilio is working with the provider to help expedite this process. New details will be shared in our incident report as soon they become available.

Cancel or release a Twilio number

Twilio phone numbers are billed on a monthly basis. Unless you are actively using a number, or you want to keep a number reserved for future use, you can reduce your costs by releasing your unused numbers. This guide explains the process.

Emergency Address Before a number can be released any registered emergency address will need to be removed either in Console or via API. Please see the following resources for how to unregister your emergency address if needed:
Console:  How to Unregister an Emergency Address from a Twilio Phone Number
API:  Emergency Calling for SIP Trunking

Release a Phone Number via Console

  1. Access the Active Numbers page in Console.
  2. Click the desired phone number you wish to release.
  3. Click Release this Number at the bottom of the window.
  4. Confirm the release on the next screen, by clicking Yes, release this number.releaseconfim.png

Release a Phone Number via the REST API

Your Twilio phone number can be released by submitting an HTTP DELETE request to the IncomingPhoneNumber REST API Resource. Here's an example cURL script:


This example will release the phone number PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX from your Twilio account. To make this script work for you, make the following updates, and then paste it into a terminal window:

For additional help, please see Delete an Incoming Phone Number in API Explorer, or our Delete an IncomingPhoneNumber REST API resource documentation.

Phone Numbers in Subaccounts

If you have set up subaccounts of your account, the phone numbers owned by your subaccounts will not appear on the Active Numbers Console page of your main account. You will need to go to the Active Numbers page for your specific subaccount to see release these numbers.

For help switching between subaccounts, please see View and Create New Twilio Subaccounts.

After Releasing a Phone Number

Once you release a number, it goes through a period of recycling and testing in order to make it look as good as new for the next owner. You also have the option of reclaiming the number back in Console within 10 days of the release. For more information, please see Restoring a previously released phone number.

It is important to keep in mind that numbers which are reclaimed to your account in this manner will have their billing cycles restarted. Essentially, you will need to buy the number again.

Please be very sure that you know what you are doing before you release a number.

Have more questions? Submit a request
Powered by Zendesk