Creating Contact Lists from CSV Files
Learn how to create new contact lists by uploading multiple contacts from CSV files or integrations, and manage existing ones with detailed information and actions.
The Contact Lists tab under Contacts shows you existing lists with lead contact details. The total number of your contact lists is shown at the top of the page.
You can create new contact lists by uploading multiple lead records from a .csv file or integration.
NOTE
All the phone numbers in the file with contact details must be in the international format and include the country prefix.
Later, you can append the list with new contacts.
Adding Contact Lists from Files
To import multiple contacts:
-
Click Create Your First Contact List on the empty page if you start your work. Next time when you already have some contact lists, just click Add List at the top right.
Contact Lists page
-
You will see a pop-up window. Select an option to import from a .csv file. Files with sizes of up to 100 MB are supported.
Add New List section
-
Enter the list name and an informative description. Then click Save & Next.
-
Browse or drag and drop the file (up to 100MB in size), then click Save & Next.
Upload File option
-
Map column titles with available contact fields as necessary. One column must contain phone numbers.
Select Ignore first line to avoid adding column titles as a separate line.
Imported Contacts Preview with the Ignore first line of the table option selected
-
Click Import Contacts.
-
View the list summary and click Continue.
Importing contacts notification
NOTE
You also need to set the contact fields that should be used in mapping and will later be applied in message campaigns to make your messages unique. You can find details in this article.
The new list appears at the top and will take some time to process.
Contact Lists page with the imported list
Refer to the following table for column descriptions in Contact Lists.
| Column | Description |
|---|---|
| List Name | Click the title to open a side panel, which you can also load when clicking the information icon in Actions. It contains details about the list, the parse status of contacts, and the campaigns in which it has been used. |
| Source | CSV or app integration |
| Progress | The Progress column shows the contact import progress. If a progress bar is displayed, the list is still being imported. The Ready status means that importing is complete. |
| Contacts | The Contacts column shows the total number of contacts in the list. You can see how many of them are parsed or failed by clicking the information icon in Actions. |
| Creation At | Date and time in UTC when the list was uploaded |
| Actions | This column provides additional controls. |
Actions
You can view more information from the Actions column and delete or download contact lists.
Actions options
To view more information about your contact list, click the information icon in the Actions column. On the List Info tab, you can see how many contact details are added (parsed) or failed to add due to invalid or not mobile phone numbers.
Actions > List Info tab
If you want more information about the list and its usage in campaigns, go to the Campaigns Info tab.
Campaigns Info tab
To delete the list, click Delete in Actions.
To save the list as a .csv file, click Download in Actions. It will take some time to prepare downloadable files for large lists. They will appear in Tasks when ready. If you would like more information, please take a look at the Tasks article.
Updated 6 days ago