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:

• Sender Configuration: Configure phone numbers and short codes for IE1 using the Regional Configuration API.
• Sending SMS: Outbound SMS using alphanumeric sender IDs, phone numbers, and short codes.
  • Programmable Messaging API Messages resource to send and manage SMS messages.
  • Messaging Services resource to manage messaging services and their sender pools.
• Receiving SMS: Inbound SMS processing with webhooks configured through either:
  • The Incoming Phone Numbers resource or the ShortCodes 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.

To send SMS with phone numbers or short codes, update the number's region to IE1 for messaging. This allows the number to send in the region and processes inbound messages in IE1.

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

1. Go to Communications > Numbers & senders > Overview, then click your phone number.
2. In the Regional tab, check your phone number's active region.
3. Click Change active region.
4. Select your desired region and click Update region.

To set a short code's region to IE1 or update a phone number's region in code, use the Regional Configuration API.

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 API 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.

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 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 sender to an IE1 Messaging Service, 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}/ShortCodes" \
2
--data-urlencode "ShortCodeSid={ShortCodeSid}" \
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 MessagingServiceSid parameter in your API request:

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

• To set a phone number webhook, go to Numbers and Senders or the service webhook from Messaging Services in the Console.
• To set short code webhooks, use the API.

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 ShortCodes resource:

1
curl -X POST "https://api.dublin.ie1.twilio.com/2010-04-01/Accounts/{AccountSid}/SMS/ShortCodes/{ShortCodeSid}.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:

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