ManyChat Help Portal
Submit a ticket

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 old Free accounts, signed up before December 10, 2020.

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 contacts will be automatically considered opted-in to the bot. Importing and creating new contacts will also affect your monthly PRO subscription.

NOTE: Effective December 10, 2020, new Free accounts will be limited to 1,000 contacts which include all subscribed, unsubscribed, and deleted contacts. Due to this the feature is available only for Pro and isn't available for new Free accounts.

Head to the Contacts 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 - and make sure it contains country code when importing. If it does not have a country code – the contact will not be treated as "Opted-in for SMS".
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 contact, 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 contacts:

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 contacts were created and how many contacts were updated.

Head to the Contacts tab and check your new contacts. 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 contact card in case their name is not added: