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.

Error 21216: "Number Is Blocked" on Outbound Calls

Issue

When attempting to place an outbound call from Twilio Flex, the call fails and returns error 21216: “Number is blocked.” This error appears in the Flex UI and/or in your application logs.

 

Product

Twilio Flex

 

Environment

Twilio Console

 

Cause

Twilio blocks certain outbound calls before connecting them to the destination for one or more of the following reasons:

  • The destination number is classified as high risk for fraud or abuse (e.g., toll fraud).
  • Regulatory restrictions prevent calls to the destination.
  • The account is attempting to call a +1 (US/Canada) destination without a valid Primary Customer Profile.
    • This can occur if:
      • The account does not have a Primary Customer Profile.
      • The account only has an Individual Customer Profile approved after October 2025 (these do not satisfy the requirement for +1 calling).

 

Resolution

  1. Confirm the Reason for the Block
  • Review the error context in Debugger or Flex logs.
  • Check if the destination is a high-risk or restricted number.
  • Verify your account’s Customer Profile status in Trust Hub.
  1. If the Block Is in Error (Legitimate Business Use)
  • If the destination is legitimate and you believe it is blocked in error, request a review by providing to our Support Team:
    • The blocked destination number
    • Your business use case for calling this number
  1. For +1 Destinations
  • Ensure your account has a valid Primary Customer Profile in Trust Hub.
    • If you only have an Individual Profile approved after October 2025, create and submit a Business Customer Profile for approval.
    • Retry the call after the profile reaches “Twilio Approved” status.
  1. Review and Adjust Dialing Permissions
  • In Console, review your Voice Dialing Geographic Permissions.
  • Enable only the countries and number ranges you expect to call to reduce exposure to toll fraud.
  1. Application Best Practices
  • Validate destination numbers in your application.
  • Rate-limit outbound call requests to avoid triggering fraud controls.

 

Additional Information 

Have more questions? Submit a request
Powered by Zendesk