You will learn
Learn how to format and import a list of SMS contacts into Klaviyo. You can only import SMS consent for people in countries where Klaviyo SMS is available.
Callout: Here, we discuss importing currently opted-in profiles. If you want to import profiles and indicate that they are not subscribed to SMS, check out How to bulk unsubscribe SMS contacts in Klaviyo.
Before you begin
Before you begin importing phone numbers, you must:
- Enable SMS
- Set up your alphanumeric sender ID
- Turn off any flows triggered by a list or the Consented to receive SMS metric
- Filter opted-out contacts from the CSV
If you don’t enable SMS, Klaviyo cannot add consent to your numbers. The numbers will still show as profiles in your account, but you won’t be able to send them SMS messages because consent isn’t applied. To avoid this, simply make sure you have set up SMS. To check that SMS is enabled in your account, navigate to Account > Settings > SMS.
Turn any flows triggered by the Consented to receive SMS metric (e.g., SMS welcome series) or a list (e.g., email welcome series) to manual mode before beginning the import process. Otherwise, after the import finishes, every new contact from that CSV will be added to the flow. You should also wait at least 2 hours after the import finishes to turn the flow live again.
Klaviyo will either add consent to all imported contacts or none of them. Therefore, it’s critical to only upload a CSV where all contacts are currently subscribed to SMS. You don’t want to accidentally text someone who never subscribed or has opted out. Not only does this provide a bad customer experience, but it is also against compliance regulations and Klaviyo’s Terms of Service.
Required information for an SMS import
To upload SMS consent, the CSV must include the following for each contact:
- Phone number
- Country, either in a column or as a country code
For more information on including a country, read How to indicate the country for an SMS import.
We recommend including the following, if available:
- *Email address
- If included, this should be the first column
- Consent timestamp
- First name
- Last name
*An email address is strongly recommended. If an email is not attached to a profile, conversions and attribution won’t be calculated correctly.
The consent timestamp is optional. It’s good to include if it’s available, but note that the timestamp must follow one of the accepted date/time formats.
If you choose not to include the timestamp, you will need to check a box to confirm that all profiles are currently opted into SMS.
How to import an SMS CSV
Steps for importing a CSV with your SMS subscribers:
- Navigate to the Lists & Segments tab on the left
- Select the list you want to add your contacts to (e.g., SMS Subscribers)
- Click Manage List
- Choose Import Contacts from the dropdown
- Choose the CSV file you want to upload
- Map each column from your CSV to an appropriate property in Klaviyo
- If there is no timestamp and you are confident the person is opted-in, click Update SMS Consent
- Review the modal that appears
- Check I acknowledge that the profiles in this import have provided explicit SMS consent to verify that you:
- Have previously obtained SMS consent from these contacts, via another SMS platform or otherwise
- Are willing to accept the legal implications of texting these contacts
- Click Update SMS Consent
- Click Review Import
- On this page, check the following:
- How many columns you are importing
- How many columns you are skipping from the original CSV file
- If SMS consent has been updated
- Click Start Import when you are ready to begin
The import process can take up to a couple of hours to complete.
Once all the numbers are imported, Klaviyo will either create a new profile or associate the data to an existing profile. For instance, if you import a phone-number-only CSV, Klaviyo will look for profiles with the same phone number, update that profile's SMS consent status, and include any other profile properties attributed to that contact.