Make an outbound phone call via REST API in a non-US Twilio Region

Before proceeding, make sure that you have the following items handy:

• Your Twilio Account SID, found on the Dashboard page of the Twilio Console
• A Voice-capable Twilio phone number

See this guide for help finding and purchasing a Twilio phone number.

Next, you'll need a Twilio API Key that is valid in the target Region.

Twilio API Keys are a Region-specific resource. In order to interact with the API in the IE1 Region, you need to use an API Key which exists in that Region (rather than an API Key you created in the default US1 Region, for example). Refer to the Twilio Regions overview for more information about the Region isolation model.

Follow these steps to create an API Key for the IE1 Region using the Twilio Console:

1. Log into the Twilio Console.
2. Click the Account menu in the upper right corner of the screen.
3. Click API keys , under the Keys & Credentials heading.
4. Select the "Ireland (IE1)" option from the Region menu.
5. Click the blue Create API key button.
6. Enter a friendly name for the key (example: "Regional Calls Quickstart").
7. Leave Key type on the default option, "Standard".
8. Click the blue Create API Key button.

Take note of the API Key's SID and secret for use in the next step.

The Twilio REST API operates on a per-Region basis. When making requests to the API, it's up to you to select which Region will handle the request. Whichever Region you choose will be the Region that processes and stores data related to the request.

If you don't specify a target Region for a request, the request will be handled in the default US1 Region.

To specify a target Region for a request, you will include the name of the target Region in the request's hostname, also known as the fully qualified domain name (FQDN).

The FQDN format follows a convention that encodes three pieces of information in the hostname:

1. The Twilio Product
2. The target Edge Location
3. The target Region

The format of an FQDN is:

{product}.{edge-location}.{region}.twilio.com

Some example FQDNs targeting API products in different Regions (through various Edge Locations) include:

In this example, you'll be making a POST request to the Call resource endpoint to create a Call. This endpoint is a part of Twilio's core API product. You will select the dublin Edge Location, and the IE1 processing Region.

Thus, the FQDN you need to use is:

api.dublin.ie1.twilio.com

If you use a MacOS or Linux operating system, you can follow these instructions to issue the request using the cURL command line utility. Otherwise, please continue to read along, since this section contains important information.

First, set some environment variables containing data that will be referenced by the curl command you run later. This practice prevents us from needing to include sensitive data directly in shell commands, and has the added benefit of making our curl command copy/pasteable without needing to adjust any placeholder values.

Create a new file named .env, and add the following content, using your own Account SID, API Key SID, and API Key secret:

1
export ACCOUNT_SID=<your_account_sid_here>
2
export API_KEY_SID=<your_api_key_sid_here>
3
export API_KEY_SECRET=<your_api_key_secret_here>

Next, add E.164 formatted phone number values for the To and From number of the phone call that you want to make. Be sure to use a From number that is either a Twilio phone number you own, or a verified phone number associated with your Twilio account.

1
export TO_NUMBER=<your_to_number_here>
2
export FROM_NUMBER=<your_from_number_here>

Save the file, and run the source command in a terminal to set the file's values as variables in your shell session:

source .env

Confirm that the variables are set by echoing one of them:

echo $TO_NUMBER

The shell should print the value of the To number that you set in the .env file.

Run the following command to issue the API request.

1
curl -X POST \
2
    -u $API_KEY_SID:$API_KEY_SECRET \
3
    https://api.dublin.ie1.twilio.com/2010-04-01/Accounts/$ACCOUNT_SID/Calls.json \
4
    --data-urlencode "To=$TO_NUMBER" \
5
    --data-urlencode "From=$FROM_NUMBER" \
6
    --data-urlencode "Twiml=<Response><Say>Ahoy from Ireland</Say></Response>"

The command should print a JSON representation of the new Call, and the destination phone should now be ringing.

Congratulations, you've successfully created a Call using a non-US1 Twilio Region!

Keep in mind that this Call will only exist in the Region where it was created — IE1 in this case. In order to view the Call log in the Twilio Console, for example, you'll need to access the IE1-specific Call Logs page. Refer to the Twilio Regions introduction for a refresher on Twilio's Region isolation model.

Real applications are unlikely to make API requests using cURL, and will instead be using an HTTP client appropriate for the application's programming language. A common choice is to use one of Twilio's language-specific server-side helper libraries.

These libraries help you issue requests against a target Region by setting a region attribute on a client instance.

For example, using one of the helper libraries, a request equivalent to the one sent using the curl command in the previous step could be sent using the following language-specific code:

1
const accountSid = process.env.ACCOUNT_SID;
2
const apiKeySid = process.env.API_KEY_SID;
3
const apiKeySecret = process.env.API_KEY_SECRET;
4

5
const toNumber = process.env.TO_NUMBER;
6
const fromNumber = process.env.FROM_NUMBER;
7

8
const client = require('twilio')(
9
    apiKeySid,
10
    apiKeySecret, {
11
        accountSid: accountSid,
12
        edge: 'dublin',
13
        region: 'ie1'
14
    });
15

16
client.calls
17
    .create({
18
        twiml: '<Response><Say>Ahoy from Ireland</Say></Response>',
19
        to: toNumber,
20
        from: fromNumber
21
    });

Now that you know the basics of making Calls via a specific Twilio Region using the REST API, check out these other resources to learn more about building with Twilio Regions:

• Route inbound calls to a non-US1 Twilio Region