Formatting your contact numbers

Apr 22, 2023

The E.164 format should be used for all recipient numbers to make sure that we can send your SMS to the right receiver. Below we will explain some more about the E.164 format and how this should be used.

Please note if you do not follow this format, you might end up sending or calling the wrong country. MessageBird does not check the validity of numbers for you. Make sure the mobile phone numbers you enter are correct and valid, otherwise you may have unnecessary costs.

Local vs. International format

When you are sending SMS or calling from your own phone to a local number, you do not need to add a country prefix to make sure your action is successful. When sending a message or calling with Messagebird, you should always make sure your numbers are internationally formatted, as in the example below:

  • US number (214)-123456 with country code +1 should be entered as 1214123456

  • UK number 020-12345678 with country code +44 should be entered as 442012345678

  • Dutch number 06-12345678 with country code +31 should be entered as 31612345678

How can I use the E.164 format? 

A number in the E.164 format can have a maximum of 15 characters and consists of the following:

  • International country calling code

  • Local area code

  • Local phone number

Depending on the destination country, phone numbers will have varying lengths. Below we have a few examples to illustrate how the numbers in E.164 format are structured: 

1214123456

  • 1 is the country code

  • 214 is the local area code for Dallas, Texas

  • 123456 is the local phone number

442012345678

  • 44 is the country code

  • 20 is the local area code for London

  • 12345678 is the local phone number

31612345678

  • 31 is the country code

  • 6 is the local area code, in this case the area is 'mobile' 

  • 12345678 is the local phone number

If you want to add the country codes to all the numbers in your excel file in one go, you can find  advice on how to do it here.