Skip to contentSkip to navigationSkip to topbar
Twilio Docs
Rate this page:
On this page

DialingPermissions BulkCountryUpdate Resource

Updates country dialing permissions in bulk.

DialingPermissions BulkCountryUpdate properties

Property nameTypePIIDescription
update_countinteger
Not PII

The number of countries updated

update_requeststring
Not PII

A bulk update request to change voice dialing country permissions stored as a URL-encoded, JSON array of update objects. For example : [ { "iso_code": "GB", "low_risk_numbers_enabled": "true", "high_risk_special_numbers_enabled":"true", "high_risk_tollfraud_numbers_enabled": "false" } ]

The UpdateRequest parameter is a URL-encoded JSON string that describes an array of objects, each object containing these properties.

Create a DialingPermissions BulkCountryUpdate resource

POST https://voice.twilio.com/v1/DialingPermissions/BulkCountryUpdates

Request body parameters

Property nameTypeRequiredPIIDescription
UpdateRequeststringrequired
Not PII

URL encoded JSON array of update objects. example : [ { "iso_code": "GB", "low_risk_numbers_enabled": "true", "high_risk_special_numbers_enabled":"true", "high_risk_tollfraud_numbers_enabled": "false" } ]

Create a BulkCountryUpdate resource to update a single country

Update the dialing permissions for Great Britain [GB]

Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_26
// Download the helper library from https://www.twilio.com/docs/node/install
_26
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_26
_26
// Find your Account SID and Auth Token at twilio.com/console
_26
// and set the environment variables. See http://twil.io/secure
_26
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_26
const authToken = process.env.TWILIO_AUTH_TOKEN;
_26
const client = twilio(accountSid, authToken);
_26
_26
async function createDialingPermissionsCountryBulkUpdate() {
_26
const bulkCountryUpdate =
_26
await client.voice.v1.dialingPermissions.bulkCountryUpdates.create({
_26
updateRequest: JSON.stringify([
_26
{
_26
iso_code: "GB",
_26
low_risk_numbers_enabled: true,
_26
high_risk_special_numbers_enabled: true,
_26
high_risk_tollfraud_numbers_enabled: false,
_26
},
_26
]),
_26
});
_26
_26
console.log(bulkCountryUpdate.updateCount);
_26
}
_26
_26
createDialingPermissionsCountryBulkUpdate();

Output

_10
{
_10
"update_count": 1,
_10
"update_request": "[{\"iso_code\":\"GB\",\"low_risk_numbers_enabled\":true,\"high_risk_special_numbers_enabled\":true,\"high_risk_tollfraud_numbers_enabled\":false}]"
_10
}

Create a BulkCountryUpdate resource to enable low-risk numbers in several countries

Enable low-risk number groups in the countries with ISO codes [US , DE , FR , GB , IL , IN , JP , AU , BR]

Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_68
// Download the helper library from https://www.twilio.com/docs/node/install
_68
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_68
_68
// Find your Account SID and Auth Token at twilio.com/console
_68
// and set the environment variables. See http://twil.io/secure
_68
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_68
const authToken = process.env.TWILIO_AUTH_TOKEN;
_68
const client = twilio(accountSid, authToken);
_68
_68
async function createDialingPermissionsCountryBulkUpdate() {
_68
const bulkCountryUpdate =
_68
await client.voice.v1.dialingPermissions.bulkCountryUpdates.create({
_68
updateRequest: JSON.stringify([
_68
{
_68
high_risk_special_numbers_enabled: false,
_68
high_risk_tollfraud_numbers_enabled: false,
_68
iso_code: "US",
_68
low_risk_numbers_enabled: true,
_68
},
_68
{
_68
high_risk_special_numbers_enabled: false,
_68
high_risk_tollfraud_numbers_enabled: false,
_68
iso_code: "DE",
_68
low_risk_numbers_enabled: true,
_68
},
_68
{
_68
high_risk_special_numbers_enabled: false,
_68
high_risk_tollfraud_numbers_enabled: false,
_68
iso_code: "FR",
_68
low_risk_numbers_enabled: true,
_68
},
_68
{
_68
high_risk_special_numbers_enabled: false,
_68
high_risk_tollfraud_numbers_enabled: false,
_68
iso_code: "GB",
_68
low_risk_numbers_enabled: true,
_68
},
_68
{
_68
high_risk_special_numbers_enabled: false,
_68
high_risk_tollfraud_numbers_enabled: false,
_68
iso_code: "IN",
_68
low_risk_numbers_enabled: true,
_68
},
_68
{
_68
high_risk_special_numbers_enabled: false,
_68
high_risk_tollfraud_numbers_enabled: false,
_68
iso_code: "IL",
_68
low_risk_numbers_enabled: true,
_68
},
_68
{
_68
high_risk_special_numbers_enabled: false,
_68
high_risk_tollfraud_numbers_enabled: false,
_68
iso_code: "JP",
_68
low_risk_numbers_enabled: true,
_68
},
_68
{
_68
high_risk_special_numbers_enabled: false,
_68
high_risk_tollfraud_numbers_enabled: false,
_68
iso_code: "BR",
_68
low_risk_numbers_enabled: true,
_68
},
_68
]),
_68
});
_68
_68
console.log(bulkCountryUpdate.updateCount);
_68
}
_68
_68
createDialingPermissionsCountryBulkUpdate();

Output

_10
{
_10
"update_count": 1,
_10
"update_request": "[{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"US\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"DE\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"FR\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"GB\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"IN\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"IL\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"JP\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"BR\",\"low_risk_numbers_enabled\":true}]"
_10
}

Create a BulkCountryUpdate resource to disable high-risk numbers in several countries

Disable high-risk number groups in the countries with ISO codes [CU , LV , SO , LT , GN , GM , ZW , MV , TN, EE]

Node.js
Python
C#
Java
Go
PHP
Ruby
twilio-cli
curl

_80
// Download the helper library from https://www.twilio.com/docs/node/install
_80
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";
_80
_80
// Find your Account SID and Auth Token at twilio.com/console
_80
// and set the environment variables. See http://twil.io/secure
_80
const accountSid = process.env.TWILIO_ACCOUNT_SID;
_80
const authToken = process.env.TWILIO_AUTH_TOKEN;
_80
const client = twilio(accountSid, authToken);
_80
_80
async function createDialingPermissionsCountryBulkUpdate() {
_80
const bulkCountryUpdate =
_80
await client.voice.v1.dialingPermissions.bulkCountryUpdates.create({
_80
updateRequest: JSON.stringify([
_80
{
_80
high_risk_special_numbers_enabled: false,
_80
high_risk_tollfraud_numbers_enabled: false,
_80
iso_code: "CU",
_80
low_risk_numbers_enabled: true,
_80
},
_80
{
_80
high_risk_special_numbers_enabled: false,
_80
high_risk_tollfraud_numbers_enabled: false,
_80
iso_code: "LV",
_80
low_risk_numbers_enabled: true,
_80
},
_80
{
_80
high_risk_special_numbers_enabled: false,
_80
high_risk_tollfraud_numbers_enabled: false,
_80
iso_code: "SO",
_80
low_risk_numbers_enabled: true,
_80
},
_80
{
_80
high_risk_special_numbers_enabled: false,
_80
high_risk_tollfraud_numbers_enabled: false,
_80
iso_code: "LT",
_80
low_risk_numbers_enabled: true,
_80
},
_80
{
_80
high_risk_special_numbers_enabled: false,
_80
high_risk_tollfraud_numbers_enabled: false,
_80
iso_code: "GN",
_80
low_risk_numbers_enabled: true,
_80
},
_80
{
_80
high_risk_special_numbers_enabled: false,
_80
high_risk_tollfraud_numbers_enabled: false,
_80
iso_code: "GM",
_80
low_risk_numbers_enabled: true,
_80
},
_80
{
_80
high_risk_special_numbers_enabled: false,
_80
high_risk_tollfraud_numbers_enabled: false,
_80
iso_code: "MV",
_80
low_risk_numbers_enabled: true,
_80
},
_80
{
_80
high_risk_special_numbers_enabled: false,
_80
high_risk_tollfraud_numbers_enabled: false,
_80
iso_code: "EE",
_80
low_risk_numbers_enabled: true,
_80
},
_80
{
_80
high_risk_special_numbers_enabled: false,
_80
high_risk_tollfraud_numbers_enabled: false,
_80
iso_code: "ZW",
_80
low_risk_numbers_enabled: true,
_80
},
_80
{
_80
high_risk_special_numbers_enabled: false,
_80
high_risk_tollfraud_numbers_enabled: false,
_80
iso_code: "TN",
_80
low_risk_numbers_enabled: true,
_80
},
_80
]),
_80
});
_80
_80
console.log(bulkCountryUpdate.updateCount);
_80
}
_80
_80
createDialingPermissionsCountryBulkUpdate();

Output

_10
{
_10
"update_count": 1,
_10
"update_request": "[{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"CU\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"LV\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"SO\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"LT\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"GN\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"GM\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"MV\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"EE\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"ZW\",\"low_risk_numbers_enabled\":true},{\"high_risk_special_numbers_enabled\":false,\"high_risk_tollfraud_numbers_enabled\":false,\"iso_code\":\"TN\",\"low_risk_numbers_enabled\":true}]"
_10
}

Rate this page: