SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site, support.twilio.com, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to help.twilio.com, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

Formatting International Phone Numbers

Calling or messaging to/from a Twilio phone number may require different formatting than calling or messaging to/from a standard local or mobile phone number. Depending on the direction and use case, you may need to use an international calling prefix, add an extra digit, or use E.164 formatting. This guide explains what type of phone number formatting to use with Twilio.

The following topics are covered:

Recent dialing changes

Here are the latest phone number dialing changes. If you have Twilio phone numbers from one of these countries, and/or dial out to them, please click the below link to review the details of the change: 

Calling or Messaging from a Twilio phone number (E.164 formatting)

Twilio recommends using E.164 formatting for all To and From phone numbers in API requests and TwiML scripts. This is an internationally-recognized standard phone number format that will help to ensure deliverability of calls and SMS messages across the globe.

Notice: Short Code messaging numbers do not require a plus sign or country code. For more information, see Formatting Short Code Numbers.

How does E.164 work?

E.164 phone number formatting entails the following:

  1. A + (plus) sign (replacing the International Call Prefix like 011)
  2. International Country Calling code
  3. Local Area code
  4. Local Phone number

For example, here’s a US-based number in standard local formatting: (415) 555-2671

US_Plain.png

Here’s the same phone number in E.164 formatting: +14155552671

US_e164.png

E.164 Mobile Numbers

In a number of countries, local dialing may require the addition of a '0' in front of the subscriber number. With E.164 formatting, this '0' must usually be removed.

For example, here’s a UK-based number in standard local formatting: 020 7183 8750

UK_Plain.png

Here’s the same phone number in E.164 formatting: +442071838750

UK_e164.png

More help with E.164 Formatting

If you need help determining the correct E.164 formatting for a phone number, consider using the Twilio Lookup API. The Lookup API can help validate any phone number to make sure it is correctly formatted to send or receive calls. Lookup also offers additional options for searching Caller ID name and Carrier information. For more details, see Getting Started with the Twilio Lookup API.

Calling or Messaging to a Twilio phone number (local formatting)

For receiving communications, Twilio phone numbers generally follow the same rules as any other local number. Domestic calls and messages to Twilio phone numbers can be dialed just like any standard number. International calls or messages to Twilio phone numbers may require a few more hoops, but can be dialed just like any standard number from the destination country.

  • Domestic example: Calling to a US-based Twilio phone number from a US-based landline or mobile phone uses the standard 10-digit dialing plan (3 digit area code followed by 7 digit local number).
  • International example: Calling to a UK-based Twilio phone number from a US-based landline or mobile phone requires the US' international direct dialing prefix (011 or a plus on your mobile phone), followed by the UK's country code (44), and then the telephone number.

Just like when calling from a mobile or landline, international dialing rules can vary depending on the caller's location and the call destination. For more guidance on how to place international calls from one country to another, reach out to your service provider, or use a resource like HowtoCallAbroad.com.

Have more questions? Submit a request
Powered by Zendesk