Skip to contentSkip to navigationSkip to topbar
On 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

country-permissions page anchor

Voice dialing permissions are organized into country permissions identified by ISO(link takes you to an external page) 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 toll fraud numbers - narrow number ranges that have a high-risk of international revenue sharing fraud (IRSF) attacks, also known as toll fraud(link takes you to an external page).
  • Low-risk numbers - low risk phone numbers

See the DialingPermission Country resource for more info.


BulkCountryUpdate permissions

bulkcountryupdate-permissions page anchor

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.


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


Inheritance Settings for Voice Dialing Permissions

inheritance-settings-for-voice-dialing-permissions page anchor

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.

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.