Import your contacts to Brevo

Our import tool makes it easy to add your contacts to Brevo. You can upload a file, copy and paste, or manually enter your data before mapping it to the correct attributes. You can choose in which lists to import your contacts and easily blocklist or update them in just a few clicks.

Good to know

Brevo cleans duplicate contacts from your import automatically. Even if you include the same contact in different lists, duplicates are removed before sending your communications so your contacts won't receive the same message twice.

Before you start

  1. Ensure your contact list is legitimate and complies with our Terms of Use and best practices (Email, SMS, WhatsApp).
  2. Create your contact import file and ensure your data is clean and well-formatted.

Step 1: Upload your contacts

Upload your contacts to Brevo by uploading a file, copying and pasting, or manually entering your data:

  1. Go to Contacts.
  2. Click Import contacts.
  3. Make sure the Contacts card is selected and click Continue.
  4. Select an import option between Upload a file and Copy/Paste
📂 Upload a file ⌨️ Copy/Paste

To directly upload a file containing all your contacts and their information to Brevo, use the Upload a file option. This is particularly useful when you have a large number of contacts to import. 

  1. Select the Upload a file option.
  2. Select your contact import file or drag and drop it within the outlined area. You will see a preview of the contacts and attribute data to be imported.
  3. Ensure your contacts and their data are separated correctly.
  4. Click Confirm your file.

Step 2: Map your data

Map your data to the attributes in your Brevo account. For instance, if you uploaded the first name of your contacts, match this data to the FIRSTNAME attribute by selecting it in the dropdown. This allows us to upload your data to the right attribute each time. If needed, you can also create new attributes or ignore some data that you do not want to import to Brevo.

Select an existing attribute Create a new attribute Ignore data
  1. Click the Contact attribute dropdown.
  2. Select the desired attribute.
    CONTACT_import_select_attribute_gif_EN.gif
💡 Good to know
When importing phone numbers, such as SMS, WhatsApp, and landline numbers, you are required to select a country code. This country code will be applied to all phone numbers in your file that do not already have a country code. For example, if you choose France as the country code, any number without a country code will automatically be assigned the French country code +33.

Once you are done mapping your data, click Confirm mapping.

Step 3: Select a list

Choose the list(s) to which you want to add your contacts. You can select a single list or multiple lists, or you can create a new list. To learn more about lists, check our dedicated article Create lists and folders to organize your contacts.

Select an existing list Create a new list
  1. Go to the Select a list tab.
  2. Select the list(s) to which you want your contacts added.
  3. Once you are done, click Confirm your list.

Step 4: Finalize your import

Before confirming your import, you need to confirm several important settings regarding how your contacts will be imported and how they should be subscribed to your communications:

Contacts management

  1. Update the attributes of the existing contacts
    Enable this option to overwrite existing contacts in Brevo with the data from your file. Disabling this option will keep the contacts that have already been imported to Brevo unchanged.
  2. Import empty fields to erase existing attribute data
    Enabling this option will result in empty fields in your import erasing any attributes that currently contain data. Disabling this option ensures that the empty fields will not affect your existing data.
  3. Blocklist the imported Email contacts
    Enabling this option will blocklist your imported contacts from receiving your email campaigns. 
  4. Blocklist the imported SMS contacts
    Enabling this option will blocklist your imported contacts from receiving your SMS campaigns. 
  5. Blocklist the imported WhatsApp contacts
    Enabling this option will blocklist your imported contacts from receiving your WhatsApp campaigns. 
    💡 Good to know
    We recommend using the Blocklist the imported Email/SMS/WhatsApp contacts options to blocklist contacts who negatively impact your metrics by reporting you as spam, not opening your messages, and so on.

Opt-in agreement

You should use Brevo to send emails, SMS, or WhatsApp messages only to contacts who have explicitly consented to receive your communications. Review our guidelines to ensure you are only importing legitimate contacts, and then check the I confirm that my new import adheres to these conditions box.

Step 5: Confirm your import

After completing the import process, click Confirm your import to start importing your contacts to Brevo. You will then be redirected to the Contacts page.

💡 Good to know
Large imports may take a few moments to fully process.

Step 6: View your import report

Once your import is completed, a banner that summarizes the details of your import will be displayed and you will receive an email notification. To view your import report, click See import report in the banner or click the bell icon 🔔 at the top-right and click the link in your last notification.

From there, you will find:

  1. The import date and source.
  2. The number of imported contacts, including new contacts, updated contacts, and unchanged contacts.
  3. Optional: Error messages if you import a contact ID that does not exist or an email address in the wrong format. You can download the table with the error messages to easily correct your data before re-importing it.
  4. Optional: Information about the blocklisted contacts.
  5. Information about the list(s) the contacts were added to.
💡 Good to know
You can download the import report by clicking the printer icon 🖨️ at the top-right and selecting Save as PDF.

⏭️ What's next?

🤔 Have a question?

If you have a question, feel free to contact our support team by creating a ticket from your account. If you don't have an account yet, you can contact us here.

If you’re looking for help with a project using Brevo, we can match you with the right certified Brevo expert partner.

💬 Was this article helpful?

148 out of 250 found this helpful