This article will discuss different topics around your users’ or customers’ phone numbers - if you’re looking for information about your own numbers, please go to our article on Short & Long Codes.
Phone numbers are shown in the User Profile in local formats, but will not be in the format you use to import the number (
(724) 123 4567).
Importing Phone Numbers
As a best practice, the best way to import a phone number is in
E.164 format. However, Braze will attempt to interpret or convert any U.S. number to the best of our ability.
All U.S. numbers must be valid, 10-digit phone numbers with a valid area code. They can be inputted without the
+ and country code, as Braze will assume and map all valid, 10-digit phone numbers as U.S. numbers.
All international numbers should start with a
+, followed by their country code and then the phone number:
However, to ensure accuracy in the event that you are sending to multiple regions with different country or area codes, it is recommended to use the
E.164 format, even for U.S.-based phone numbers.
You can see the differences between local number formatting as well as universal,
E.164 formatting in the table below:
As you can see, the country codes for each listing are:
Adding Users to SMS Subscription Groups
For a customer to receive an SMS message, they must have a valid phone number and be opted-in to a Subscription Group. Subscription Groups are tied to the SMS program you are running (make sure you follow the legal laws for SMS and have recorded consent for each customer)