Import and sync contacts with a remote file through FTP/SFTP

💡 Good to know
The FTP contacts integration is only available on an Enterprise plan. For more information, check our website or get in touch with our Sales team.

Effortlessly sync a remote file containing contacts and their information with Brevo in just minutes via FTP/SFTP. Keep it updated at your preferred frequency, all without needing to write a single line of code.

About the FTP contacts integration

  • We currently support .csv and .txt files with values separated by either a comma or a semicolon. However, we do not support tab-separated values.
  • You cannot sync boolean-type attributes.
  • There’s a global limit on how much data, your integrations can pull or sync with. This limit is set to 100,000 tasks/month. You'll receive an email notification when you reach 80% of your monthly quota. If you exceed this limit, your integrations will be stopped and you'll receive a new email notification informing you about that. To increase your monthly quota, feel free to contact our support team by creating a ticket from your account.

Before you start

We recommend you contact the IT department of your company and request them to add the IPs used for sending information via the FTP server to your allowlist:

List of IPs
  • 35.202.19.80
  • 34.123.159.157
  • 35.184.137.211
  • 35.225.183.63
  • 34.133.93.129
  • 34.134.46.50
  • 34.67.26.223
  • 35.224.241.170
  • 34.172.210.93
  • 34.121.137.22
  • 35.239.149.211
  • 34.132.210.92
  • 34.135.198.27
  • 34.136.192.205
  • 104.154.129.182
  • 35.225.136.162
  • 34.71.190.210
  • 34.69.255.254
  • 35.225.242.199
  • 35.226.149.146
  • 35.239.133.224
  • 35.184.108.4
  • 34.67.79.227
  • 35.192.52.76
  • 146.148.87.103
  • 34.136.182.21

Step 1: Set up the FTP contacts integration

First, set up the FTP Contacts integration on your Brevo account:

  1. Click your account name and select Plugins & Integrations.
  2. Select the FTP contacts integration.
  3. Name the integration.
  4. Click Create integration.

Step 2: Configure FTP

Connect the integration to your FTP server:

  1. In the Host field, enter the appropriate protocol (ftp:// or sftp://), followed by ftp. and the URL of your FTP server (e.g., ftp://ftp.myserver.com or sftp://ftp.myserver.com).
  2. In the Username field, enter your FTP username.
  3. In the Password field, enter your FTP password.
  4. In the Port field, enter the server port you want to use for file transfer. 
    ftp_credentials_protocol_en-us.png
    💡 Good to know
    If you did not include the appropriate protocol in the Host field, use port 21 for an FTP connection or port 22 for an SFTP connection.
  5. Click Quick connect.
  6. After a few seconds, you will see either a success or failure message indicating the result of the connection attempt:

    • ✅ If the connection was successful, click Continue.

    • ❗️ If your credentials are incorrect, you won't be able to proceed and will need to provide the correct credentials. This error message will be displayed: "Impossible to connect to server".
      ftp_impossible-to-connect_en-us copy.jpeg

Step 3: Select a file

💡 Good to know

If needed, you can add a new file to your FTP server at this step and click the ↪️ Refresh button next to the dropdowns to reload the list of available files.

  1. Select the folder and file that you want to sync contacts from:
    1. From the Folder dropdown, select the folder the file is stored in. The root folder is displayed as /.
      ❗️ Important
      Only the root folder and folders on the same level can be selected.
    2. From the File dropdown, select the .csv or .txt file that you want to sync contacts from.
      ftp_folder-file_en-us.jpeg
  2. Click Continue.

Step 4: Map the data fields from your file with your Brevo contacts attributes

💡 Good to know
If no data is visible at this step, ensure that your file includes contact information that can be mapped.
  1. (Optional) To import the contacts in your file as blocklisted contacts in Brevo, select the Contact Blocklisting option.
    ftp_blocklist-contacts_en-us.jpeg
  2. Use the dropdowns to map the Brevo contact attributes from the Contact Attribute column to the data fields from the FTP Attribute column.
  3. (Optional) If you prefer not to sync a specific contact attribute, select Do not import from the dropdown.
    ftp_map-attributes_en-us.jpeg
  4. Click Continue.

Step 5: Select a Brevo list

Select the Brevo list where you want to synchronize the contacts in your file:

Select a list Create a list
  1. In the Select a list tab, select the existing list where you want to synchronize the contacts in your file.
    ftp_select-list_en-us.jpeg
  2. Click Continue.

Step 6: Set the import frequency

Manage the frequency at which the integration should sync the contacts in your file to Brevo:

  1. Sspecify when your file should be read and synced to Brevo:
    • Specific days of the week
      Select the specific day(s) and time at which the file should be checked and synced.
      ftp_frequency_days-of-week_en-us.jpeg
    • Specific day of the month
      Select a specific day of the month and the time at which the file should be checked and synced.
      ftp_frequency_day-of-month_en-us.jpeg
  2. Click Continue.

Step 7: Activate the integration

Click Save and Activate now. You will be redirected to the My Integrations page, where you can view the newly created integration.

💡 Good to know
Click Save and keep inactive to keep the integration as a draft. You can activate it later at any time.

⏭️ 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?

2 out of 7 found this helpful