ManyChat
Submit a ticket

Import Contact List

Contact list importing allows you to upload your external contact phone/email list and use it with SMS/Email marketing channel in ManyChat. This feature is available to all users, both Pro and Free.

You can upload only those contacts that gave you consent to receive SMS or Email - note that you are responsible for collecting such consent outside of ManyChat. When you upload contacts to ManyChat, your subscribers will be automatically considered opted-in to the bot. Importing and creating new subscribers will also affect your monthly PRO subscription.


Head to the Audience tab and click Import button:

Then, click Select your file:

Select your CSV file with the contact list:

NOTE: If you'd like to import a large number of contacts, we highly recommend importing them in separate chunks, each containing no more than 20,000 lines. We also recommend naming each column in the first row (First Name, Last Name, Phone, Email, Country, etc).


Check that you have selected the correct file and mark the checkbox at the bottom. Next, click the blue Next button to proceed.

Match CSV columns to System and Custom Fields:

NOTE: You must select Full Name/First Name/Last Name/Gender/Phone/Email System Fields for the corresponding columns in your CSV. You will be able to change Phone only afterwards - make sure it contains country code when importing.


Please save all other values to Custom Fields - you can create them right in the drop-down or in Settings > Custom Fields.

The data gets matched with the data of existing contacts. Here is how it works:

The system gets data from the CSV file and maps it to System and Custom Fields. If Phone or Email in the file matches those that are tied to an existing subscriber, ManyChat would update the data, so that it matches the CSV file. If the system finds no matches in Email and/or Phone, it would create a new contact.

Check the number of columns for import and select/create Tag for the imported audience:

You can add several Tags if you wish, or delete them:

You will see a circular progress bar once the contacts start importing:

And when it's ready, you will see how many users were created and how many users were updated.

Head to the Audience tab and check your new Subscribers. In the example below, contacts were uploaded without First Name and Last Name - their name will be based on their Email or Phone.

Please note that you are not able to edit the imported contact's name and avatar. Here's how you will see their user card in case their name is not added: