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 Community Forums or browsing the Twilio tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. Please select the reason(s) for your feedback or provide additional information about how we can improve:

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

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more