You will learn

Learn which phone number formats Klaviyo accepts when importing phone numbers for SMS marketing.

Accepted phone number formats

You can use several different formats for phone numbers with Klaviyo.

The following applies to Klaviyo's list import tool only. If you're using an API call, note that Klaviyo only accepts the E.164 format.

Format

Example without country code

Example with country code

E.164

2345678901

+12345678900

2-345-678-901

+12-345-678-900

2 345 678 901

+12 345 678 900

RFC3966

tel: 2345678901

tel: +12345678900

E.123 national notation

(234) 567 8901

(+1234) 567 8900

2345678901

+12345678900

E.123 international notation

2 345 678 901

+12 345 678 900

234 567 8901

+1 234 567 8900

When importing phone numbers, you must include the country. Generally, the best way to do so is by adding a column labeled Country.

The RFC3966 format comprises the prefix “tel:” followed by numbers. The numbers themselves do not need to be in a certain format.

Branded sender IDs are not accepted, but you will get one free with your SMS plan.

Importing phone numbers

In order for consent to be applied to a phone number, we recommend including the following columns:

  • Email (if known)
  • Phone number (required)
  • Country
  • First name
  • Last name
  • Timestamp

This way, the file contains all the necessary and helpful information. Not only will consent be applied properly, but you'll avoid creating duplicate profiles.

For more details, read upload a list of SMS contacts.

Including a country

You must indicate the country for a phone number to be accepted for SMS. You can either:

  • Include a column for the country
    or
  • Add a country code at the beginning of the phone number
    • Note that you have to add an apostrophe before the plus sign (e.g., '+) in Google Sheets and Excel due to formatting issues.

For instructions on formatting countries in CSVs, please see how to include a country for an SMS import.

With the country column

Sample CSV file for importing SMS consent into Klaviyo when there’s a country column

With the country code

Sample CSV file for importing SMS consent into Klaviyo when there’s a country code

mceclip0.png
mceclip0.png

How Klaviyo handles symbols and spaces

Klaviyo can also handle certain typos and common symbols. For instance, if a phone number contains a symbol, extra space, or letter, Klaviyo will remove this when a phone number is added to a profile. The following will all be corrected to the E.164 format as +12345678900:

  • +12/345(678)*900
  • +12()*- 345678900
  • abcde()*()++12 345 678 900
  • +1-2-3-4-5-6-7-8-9-0-0

Additional resources

  • How to upload a list of SMS contacts

    Find out how to add and remove SMS transactional or marketing consent in Klaviyo. Importing your SMS subscribers is an essential part of migrating providers or simply consolidating your data.

  • Understanding SMS consent collection

    Learn about SMS consent, including what counts as SMS consent, how you can collect it, and how resubscribes work. SMS consent refers to whether someone is opted in (i.e., if they have agreed to receive marketing text messages from your brand).

Was this article helpful?
Use this form only for article feedback. Learn how to contact support.

Explore more from Klaviyo

Community
Connect with peers, partners, and Klaviyo experts to find inspiration, share insights, and get answers to all of your questions.
Partners
Hire a Klaviyo-certified expert to help you with a specific task, or for ongoing marketing management.
Support

Access support through your account.

Email support (free trial and paid accounts) Available 24/7

Chat/virtual assistance
Availability varies by location and plan type