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
sipTrunkDomainstring

Optional

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
accountSidSID<AC>

Optional

Not PII

The unique SID identifier of the Account.

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

Optional

Not PII

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

voiceRegionstring

Optional

Not PII

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

dateCreatedstring<date-time>

Optional

Not PII

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

dateUpdatedstring<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
sipTrunkDomainstring
required
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
sipTrunkDomainstring
required
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
voiceRegionstring

Optional

Not PII

The Inbound Processing Region used for this SIP Trunk for voice

friendlyNamestring

Optional

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
}