Use the Programmable Messaging API with Twilio Regions

With SMS in the IE1 region, you can use the Programmable Messaging API to send and receive SMS messages with EU Data Residency. This includes:

• Configuring the phone number to be used in IE1 using the new Twilio Console or Phone Number Regional Configuration API.
• Sending outbound SMS using alphanumeric sender IDs and phone numbers that have been enabled in the IE1 region.
  • Programmable Messaging API Messages resource to send and manage SMS messages.
  • Messaging Services resource to manage messaging services and their senders.
• Inbound SMS processing with webhooks configured through either:
  • The Incoming Phone Numbers resource.
  • Messaging Services webhooks.

For an in-depth list of available Messaging features in IE1, see Messaging IE1 Feature Availability.

You can access these messaging features for SMS in IE1 in the new Twilio Console:

• Configuring phone numbers for IE1 in Numbers and Senders.
  • Setting a phone number's active region to IE1 from the Regional tab.
  • Configuring a phone number's webhook from the Messaging tab.
• Managing Messaging Services in IE1.
• Messaging Logs in IE1.
• Messaging Insights in IE1.

For an in-depth list of available Messaging features in IE1, see Messaging IE1 Feature Availability.

Any Twilio customer can use the Programmable Messaging API in IE1. To get started, follow these steps:

To authenticate requests to the IE1 Region, you must create region-specific API keys. See Manage regional API credentials to get started.

If you plan on sending with phone numbers, you must update the phone number's active region to IE1 for messaging. This ensures that inbound messages and webhooks configured on the phone number are processed in IE1.

To set a phone number active region to IE1, follow these steps in the Console:

1. Navigate to Numbers & Senders > Phone Numbers, then select your phone number.
2. In the Regional tab, check your phone number's active region.
3. Click Change active region.
4. Select the region you want to switch to, and click Update region.

Use the Phone Number Regional Configuration API to set the active region programmatically.

Alphanumeric sender IDs do not require additional configuration to be used in IE1, since they do not support inbound messaging.

Once your credentials and senders are prepared, you can begin sending messages by targeting the IE1-specific base AP URLs or by configuring your SDK to use the IE1 region. See the API or SDK sections for details and examples.

To make API requests to the IE1 Region, use the following base URLs:

To send an SMS message through the IE1 Region, make a POST request to the Messages resource using the IE1 base URL.

1
curl -X POST "https://api.dublin.ie1.twilio.com/2010-04-01/Accounts/*ACCOUNT_SID*/Messages.json" \
2
--data-urlencode "Body=Hello from IE1!" \
3
--data-urlencode "From=+35XXXXXXXXXX" \
4
--data-urlencode "To=+35XXXXXXXXXX" \
5
-u {IE1_API_KEY_SID}:{IE1_API_KEY_SECRET}

You can create and manage messaging services using the Services resource in IE1 or Messaging Services in the Console. For a list of Messaging Service features currently supported in IE1, see Messaging IE1 Feature Availability.

To create a Messaging Service in the IE1 Region, make a POST request to the Services resource using the IE1 base URL.

1
curl -X POST "https://messaging.dublin.ie1.twilio.com/v1/Services" \
2
--data-urlencode "FriendlyName=My IE1 Messaging Service" \
3
-u {IE1_API_KEY_SID}:{IE1_API_KEY_SECRET}

To add a Messaging Service sender in IE1, make a POST request to the appropriate subresource under the Messaging Service using the IE1 base URL.

1
curl -X POST "https://messaging.dublin.ie1.twilio.com/v1/Services/{ServiceSid}/PhoneNumbers" \
2
--data-urlencode "PhoneNumber=+35XXXXXXXXXX" \
3
-u {IE1_API_KEY_SID}:{IE1_API_KEY_SECRET}

To send messages with the Messaging Service in IE1, include the Messaging Service SID as the From parameter in your API request:

1
curl -X POST "https://api.dublin.ie1.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages.json" \
2
--data-urlencode "Body=Hello from IE1 Messaging Service!" \
3
--data-urlencode "From={ServiceSid}" \
4
--data-urlencode "To=+35XXXXXXXXXX" \
5
-u {IE1_API_KEY_SID}:{IE1_API_KEY_SECRET}

Inbound webhooks for messages received in IE1 can be configured at the phone number or messaging service level.

Set a phone number webhook from Numbers and Senders or the service webhook from Messaging Services in the Console.

Using the Incoming Phone Numbers resource:

1
curl -X POST "https://api.dublin.ie1.twilio.com/2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers/{PhoneNumberSid}.json" \
2
--data-urlencode "SmsUrl=https://www.example.com/sms" \
3
--data-urlencode "SmsMethod=POST" \
4
-u {IE1_API_KEY_SID}:{IE1_API_KEY_SECRET}

Using the Messaging Services resource:

1
curl -X POST "https://messaging.dublin.ie1.twilio.com/v1/Services/{ServiceSid}" \
2
--data-urlencode "InboundRequestUrl=https://www.example.com/sms" \
3
--data-urlencode "InboundMethod=POST" \
4
--data-urlendcode "useInboundWebhookOnNumber=false" \
5
-u {IE1_API_KEY_SID}:{IE1_API_KEY_SECRET}

When using Twilio SDKs, specify the edge and region parameters to target the IE1 Region. For example, using the Node.js SDK:

1
const twilio = require('twilio');
2

3
const ie1ApiKey = 'IE1_API_KEY';
4
const ie1ApiSecret = 'IE1_API_SECRET';
5

6
const client = twilio(ie1ApiKey, ie1ApiSecret, {
7
  accountSid: accountSid,
8
  edge: 'dublin',
9
  region: 'ie1'
10
});