SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site, support.twilio.com, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to help.twilio.com, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

How Can I Stop Receiving or Block Incoming Phone Calls?

Twilio gives users a number of methods for blocking incoming calls. While all Twilio phone numbers go through a testing process before they're made available for purchase, some unwanted calls may continue to reach your Twilio line. Here are some tips to help prevent these calls from becoming a problem:

Block All Incoming Calls

If you do not want to receive any phone calls on your Twilio phone number, you can configure your number with a blank Voice Webhook URL. With an empty webhook, this phone number is considered 'out of service' for inbound calls. You will not be charged for any incoming calls in this state, nor will these calls be received and logged in your project.

Steps for submitting a blank Voice Webhook URL on your on your Twilio number can be found here: Configuring Phone Numbers to Receive Voice Calls - Webhook.

Reject and Track All Incoming Calls

You can achieve similar results by responding to incoming calls with the <Reject> TwiML verb. The only difference between this method, and using a blank webhook, is that using <Reject> logs these incoming calls in your Twilio project logs; calls will continue to be blocked at no charge to you.

The easiest way to do this is with a TwiML Bin. Here are the instructions:

  1. Access the TwiML Bins page in Console.
  2. Click Create New TwiML Bin, or the red plus + sign button.
  3. Add a Friendly Name and some TwiML, and then click Create.
    • Friendly Name: This is up to you - we recommend using something that gives an idea of what the TwiML Bin will do like “Reject Calls”.
    • TwiML: For the code, you will use the <Reject> verb. Your code should look something like this:
      <Response>
          <Reject />
      </Response>
  4. Configure this TwiML Bin on your Twilio number by following the steps here: Configuring Phone Numbers to Receive Voice Calls - TwiML Bin.

Reject Calls from Specific Phone Numbers

You can create a "virtual block list" to reject incoming phone calls from specific phone numbers. This block list lets you automatically respond to certain number with the <Reject> TwiML verb, and then forward other callers as normal.

For help setting up phone number blocking, please see Reject Incoming Calls with a Phone Number Block List.

Reject Calls from Specific Countries

You can create a "virtual block list" to reject incoming phone calls from specific countries as well. This type of block would automatically respond to calls from countries on the list with the <Reject> TwiML verb, and then forward other callers as normal.

For help blocking calls based on the originating country, see Reject Incoming Calls with a Country Block List.

Have more questions? Submit a request
Powered by Zendesk