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

Inbound Processing Region API - Trunk

In the context of the Inbound Processing Region API, a Trunk resource represents the routing configuration for a particular Elastic SIP Trunk.

By adjusting the value of the voice_region property, you can control which Twilio Region will process and store data related to inbound calls for the Trunk.

(warning)

Warning

Changes to this resource may take up to 5 minutes to take effect.

Trunk properties

trunk-properties page anchor
Property nameTypeRequiredDescriptionChild properties
sip_trunk_domainstringOptional
Not PII

The absolute URL of the SIP Trunk

urlstring<uri>Optional
Not PII

The absolute URL of the resource.

sidSID<QQ>Optional
Not PII

A 34 character string that uniquely identifies the Inbound Processing Region assignments for this SIP Trunk.

Pattern: ^QQ[0-9a-fA-F]{32}$Min length: 34Max length: 34
account_sidSID<AC>Optional
Not PII

The unique SID identifier of the Account.

Pattern: ^AC[0-9a-fA-F]{32}$Min length: 34Max length: 34
friendly_namestringOptional
Not PII

A human readable description of the Inbound Processing Region assignments for this SIP Trunk, up to 64 characters.

voice_regionstringOptional
Not PII

The Inbound Processing Region used for this SIP Trunk for voice.

date_createdstring<date-time>Optional
Not PII

The date that this SIP Trunk was assigned an Inbound Processing Region, given in ISO 8601 format.

date_updatedstring<date-time>Optional
Not PII

The date that the Inbound Processing Region was updated for this SIP Trunk, given in ISO 8601 format.

Fetch a Trunk's current Inbound Processing Region configuration

fetch-a-trunks-current-inbound-processing-region-configuration page anchor
GET https://routes.twilio.com/v2/Trunks/{SipTrunkDomain}

Path parameters

path-parameters page anchor
Property nameTypeRequiredPIIDescription
SipTrunkDomainstringrequired
Not PII

The absolute URL of the SIP Trunk

Fetch a Trunk's current Inbound Processing Region configurationLink to code sample: Fetch a Trunk's current Inbound Processing Region configuration
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

3


4
// Find your Account SID and Auth Token at twilio.com/console

5
// and set the environment variables. See http://twil.io/secure

6
const accountSid = process.env.TWILIO_ACCOUNT_SID;

7
const authToken = process.env.TWILIO_AUTH_TOKEN;

8
const client = twilio(accountSid, authToken);

9


10
async function fetchTrunks() {

11
  const trunk = await client.routes.v2

12
    .trunks("example.pstn.twilio.com")

13
    .fetch();

14


15
  console.log(trunk.voiceRegion);

16
}

17


18
fetchTrunks();

Output

1
{

2
  "sip_trunk_domain": "example.pstn.twilio.com",

3
  "url": "https://routes.twilio.com/v2/Trunks/test.pstn.twilio.com",

4
  "account_sid": "AC00000000000000000000000000000000",

5
  "sid": "QQ00000000000000000000000000000000",

6
  "friendly_name": "string",

7
  "voice_region": "string",

8
  "date_created": "2022-06-02T22:33:47Z",

9
  "date_updated": "2022-06-02T22:33:47Z"

10
}

Update a Trunk's Inbound Processing Region configuration

update-a-trunks-inbound-processing-region-configuration page anchor
POST https://routes.twilio.com/v2/Trunks/{SipTrunkDomain}

Path parameters

path-parameters-1 page anchor
Property nameTypeRequiredPIIDescription
SipTrunkDomainstringrequired
Not PII

The absolute URL of the SIP Trunk

Request body parameters

request-body-parameters page anchor
Encoding type:application/x-www-form-urlencoded
SchemaExample
Property nameTypeRequiredDescriptionChild properties
VoiceRegionstringOptional
Not PII

The Inbound Processing Region used for this SIP Trunk for voice

FriendlyNamestringOptional
Not PII

A human readable description of this resource, up to 64 characters.

Update a Trunk's Inbound Processing Region configurationLink to code sample: Update a Trunk's Inbound Processing Region configuration
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

3


4
// Find your Account SID and Auth Token at twilio.com/console

5
// and set the environment variables. See http://twil.io/secure

6
const accountSid = process.env.TWILIO_ACCOUNT_SID;

7
const authToken = process.env.TWILIO_AUTH_TOKEN;

8
const client = twilio(accountSid, authToken);

9


10
async function updateTrunks() {

11
  const trunk = await client.routes.v2

12
    .trunks("example.pstn.twilio.com")

13
    .update({ voiceRegion: "au1" });

14


15
  console.log(trunk.voiceRegion);

16
}

17


18
updateTrunks();

Output

1
{

2
  "sip_trunk_domain": "example.pstn.twilio.com",

3
  "url": "https://routes.twilio.com/v2/Trunks/test.pstn.twilio.com",

4
  "sid": "QQaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

5
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

6
  "friendly_name": "friendly_name",

7
  "voice_region": "au1",

8
  "date_created": "2020-08-07T22:29:24Z",

9
  "date_updated": "2020-08-07T22:29:24Z"

10
}