Guide to Uploading a List of SMS Contacts

Last updated at:


If you are migrating over from another SMS provider or already have an existing list of SMS subscribers, you can upload these to Klaviyo to start building out your SMS marketing strategy. 

Please note that it is required that you have previously obtained consent from these subscribers, otherwise, you will not be able to text them. It is against Klaviyo's Terms of Service and SMS compliance laws to market to contacts who have not explicitly opted-in to receive SMS communication from your business.

If you're not sure if you've collected SMS consent, follow our guide to acquiring SMS subscribers for best practices around obtaining consent from contacts that you may already have in your account.

Before You Get Started

Before uploading SMS contacts to a list, turn off any flows that are triggered by: 

  • The list you are importing to
  • The Consented to Receive SMS metric

The reason for this is that once you import these contacts, they'll be immediately scheduled for flows triggered by this list or metric. This can lead to a less-than-ideal customer experience, as these flows are typically targeted to new subscribers, whereas your imported contacts subscribed some time in the past. From their point of view, if they subscribed a year ago and then suddenly get a welcome message, this can be a cause for concern. It's better to avoid this by simply turning off such flows. To do so, you can bulk update the flow actions to either manual or draft mode. 

After importing, wait for at least one hour before turning your flows live again. 

In addition, check your available sending numbers in Account > Settings > SMS. You must have a sending number for every country that you want to upload SMS consent. For instance, if you are trying to upload consent for profiles in Canada and the UK, you must have both a toll-free number and alphanumeric sending ID. 

Format Your List of SMS Contacts

You will need to import your file of SMS contacts as a CSV or via copy and paste from a CSV or Excel sheet. Note that currently, you cannot quick add SMS subscribers.

There are two key data points the CSV file must have, represented by headers:

  • Phone Number (required)
    A contact's phone number must be in the E.164 (e.g., +12345678910), RFC966 (e.g., +12-34-567-8910), or E.123 national (e.g., 12345678910) or international (e.g., +12 345 678 910) formats. Always include the country code. 
  • Country (required)
    It's important to indicate the country (e.g., USA, United States, or US) for the phone number. You can only import consent for contacts in countries where Klaviyo SMS is available. Having a column labeled "Country" is the best practice, but the import will also work if you add the country code to the phone number instead (e.g., +1 for the USA). To do so, add an apostrophe and (if it's not already included) a plus sign before the number so that it's formatted correctly (e.g., '+12345678910). 

Optionally, you may also add additional headers to this file to map data to existing Klaviyo properties or any desired custom properties. Then, follow the instructions outlined in our general guide to importing lists to add your contacts to Klaviyo.

If you have the SMS consent timestamp, add a column for this in the CSV. Note that it must be formatted in one of Klaviyo's accepted datetime formats (e.g., 2019-09-01 13:34:08+00:00). If you do not have a timestamp, you will need to update the consent status.

The following examples are both acceptable formats for the CSV file. 


Map Your Data

After you upload your list, you will be brought to the Field Mapping page. Your phone number header will automatically map to Klaviyo's Phone Number property, which you can verify here.


If you uncheck the SMS Consent Timestamp box during the mapping process, you will be able to upload your list of contacts successfully, but won't be able to text these contacts until the SMS Consent Timestamp field has been added.

SMS sending is only available in certain countries. If you upload a number belonging to a country where Klaviyo SMS is not available, consent will not be stored. Check out this article to learn where you can use Klaviyo SMS


Additionally, if you attempt to upload a list with phone numbers but without an SMS Consent Timestamp column, you will be prompted to update the consent status of these contacts before you finish importing the list. You may proceed through this process without adding a consent timestamp, but you will not be able to text these contacts.

Once you are satisfied with how the fields are mapped, click Import Review to proceed to the final stage of the import process.

Update Consent Status

If you do not have SMS Consent Timestamps in your CSV file, you will still be able to update the consent status. It is imperative that you only do this if you have, at some point, explicitly received consent from these contacts. Otherwise, you will be in violation of Klaviyo's Terms of Service and TCPA laws. If you are confident you have previously received consent, click Update SMS Consent.


Review the modal carefully. If you check I acknowledge that the profiles in this import have provided explicit SMS consent, you are verifying that you have previously obtained consent from these contacts, via another SMS platform or otherwise, and are willing to accept the legal implications of texting these contacts. 


Once you check this box, you may click Update SMS Consent once more. You will be brought back to the Field Mapping page, where you will see a row for SMS Consent Timestamp. For all contacts, this field will be populated with the timestamp at which you clicked to confirm Update SMS Consent. You will not be able to edit or update this field. If you decide that you don't want to proceed with updating the consent status of these contacts, you can click Cancel SMS Consent Update.

Review Your Import

On the final page of the import process, you will be able to review how many columns you are importing and how many you are skipping from the original CSV file, as well as if SMS consent has been updated (if applicable).

Additional Resources

Was this article helpful?
101 out of 157 found this helpful