Use TaskRouter with Twilio Regions

To use TaskRouter in IE1, complete the following steps.

1. In the Twilio Console, use the region selector to switch to Ireland (IE1). When you set the Console to the IE1 region, created Workspaces, TaskQueues, and Workers only exist in IE1.

2. Use Region-specific credentials. Twilio isolates its Regions. When you target IE1, a US1 Auth Token or API key doesn't work. To learn more, see Manage Regional API Credentials.

   1. In the Console, go to API keys & tokens.
   2. Change the region selector to Ireland (IE1).
   3. Find your IE1 Auth Token.
   4. Create API keys with the Console region selector set to Ireland (IE1). Any keys you create only work in IE1.

3. Send TaskRouter API requests to the dublin edge, using the following base URL.

   Resource	Base URL
   TaskRouter REST API	taskrouter.dublin.ie1.twilio.com

   Using the Twilio CLI, sign in with the IE1 region and the dublin edge.

   Copy code block

   twilio login --region ie1 --edge dublin

   Using a Twilio helper library, pass both the region and the edge when you create the client. In Node.js:

   Copy code block

   const client = require('twilio')(accountSid, authToken, { region: 'ie1', edge: 'dublin' });

If your application uses the TaskRouter JS SDK to build a Worker-facing UI, pass region: 'ie1' to both the Worker's Access Token and the Worker client. The JS SDK doesn't take an edge parameter — only region.

1
const token = new AccessToken(accountSid, apiKeySid, apiKeySecret, {
2
  identity: workerIdentity,
3
  region: 'ie1',
4
});
5
token.addGrant(new AccessToken.TaskRouterGrant({ workerSid, workspaceSid, role: 'worker' }));

const worker = new Worker(token.toJwt(), { region: 'ie1' });

A Workspace that runs in IE1 can only reference TaskQueues, Tasks, Workers, and Workflows that also exist in IE1. You can't mix US1 and IE1 resources within a single Workflow.