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.

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:

curl -X DELETE \

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