Rate this page:

Dialing Permissions resources

Twilio allows you to initiate outbound voice calls to the public telephone network in over 218 countries and territories around the world. Account level Voice Dialing Geographic Permissions allows you to control which of those countries can be called and also block destinations in countries with a high-risk of toll fraud.

For our partners that build and re-sell Twilio powered solutions using subaccounts, Twilio has provided the ability for a subaccount to inherit the dialing permissions of the Master Project. If the partner's customer (the tenant of the subaccount) requires a unique set of permissions, inheritance can be disabled and dialing permissions can be customized on that subaccount.

With this REST API for voice dialing permissions, you can create smart defaults for customers during signup. Smart defaults, aligned with customer needs, leads to more successful calls and more conversions.

Country permissions

Voice dialing permissions are organized into country permissions identified by ISO code of corresponding country.

Each Voice DialingPermission Country resource describes these three groups of phone number prefixes.

  • High risk special numbers - number types such as premium numbers, special services, shared cost, and others
  • High risk tollfraud numbers - narrow number ranges that have a high-risk of international revenue sharing fraud (IRSF) attacks, also known as toll fraud.
  • Low risk numbers - low risk phone numbers

See the DialingPermission Country resource for more info.

BulkCountryUpdate permissions

Voice dialing permissions for a country are updated by using the DialingPermissions BulkCountryUpdate resource.

Voice dialing permissions for a country can be updated individually or in a group of countries. See the DialingPermissions BulkCountryUpdate resource for more info.

High-Risk Prefixes

The list of high-risk prefixes from a country is returned by the DialingPermissions HighRiskSpecialPrefix resource.

Inheritance Settings for Voice Dialing Permissions

The inheritance settings for voice dialing permissions are represented by the DialingPermissions Settings resource.

You can list and update a subaccount's inheritance settings for voice dialing permissions by using the DialingPermissions Settings resource.

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Loading Code Sample...

        Thank you for your feedback!

        Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!