How should phone numbers be formatted?

You are here:
Estimated reading time: < 1 min
In this article

You can import user phone numbers to send text messages to those using our system. Currently we have integration with Twilio and SMSAdvert.

The number format needs to follow the following format:

[+ country_prefix] phone_number

For example:

+34912345678 Spain number

+1456-456-9845 US phone number

When we do receive the “tel” attribute for any user, either through import or events, we remove and other characters than digits, but we keep + as the prefix, if it exists.


  • we do not validate the format of phone numbers
  • it’s up to you to provide valid phone numbers, or sending the text messages will not work
  • at some point we plan to add the prefix automatically for each account, but it’s not planned yet. Best is to provide only valid phone numbers.
Was this article helpful?
Dislike 0
Views: 16