Sign in

v1

latestSwagger 2.0MIT2026-07-17233380637.0 KB
Contacts

Import contacts

It returns the background process ID which on completion calls the notify URL that you have set in the input.

Note:

  • Any contact attribute that doesn't exist in your account will be ignored at import end.
post/contacts/import

Request body

fileUrlstring url

Mandatory if fileBody or jsonBody is not defined. URL of the file to be imported (no local file). Possible file formats: .txt, .csv, .json

fileBodystring

Mandatory if fileUrl and jsonBody is not defined. CSV content to be imported. Use semicolon to separate multiple attributes. Maximum allowed file body size is 10MB . However we recommend a safe limit of around 8 MB to avoid the issues caused due to increase of file body size while parsing. Please use fileUrl instead to import bigger files.

listIdsinteger[]

Mandatory if newList is not defined. Ids of the lists in which the contacts shall be imported. For example, [2, 4, 7].

notifyUrlstring url

URL that will be called once the import process is finished. For reference, https://help.brevo.com/hc/en-us/articles/360007666479

emailBlacklistboolean

To blacklist all the contacts for email

disableNotificationboolean

To disable email notification

smsBlacklistboolean

To blacklist all the contacts for sms

updateExistingContactsboolean

To facilitate the choice to update the existing contacts

emptyContactsAttributesboolean

To facilitate the choice to erase any attribute of the existing contacts with empty value. emptyContactsAttributes = true means the empty fields in your import will erase any attribute that currently contain data in Brevo, & emptyContactsAttributes = false means the empty fields will not affect your existing data ( only available if updateExistingContacts set to true )

Example request

{
  "fileUrl": "https://importfile.domain.com",
  "fileBody": "NAME;SURNAME;EMAIL\nSmith;John;john.smith@example.com\nRoger;Ellie;ellie36@example.com",
  "listIds": [
    76
  ],
  "notifyUrl": "http://requestb.in/173lyyx1",
  "newList": {
    "listName": "ContactImport - 2017-05",
    "folderId": 2
  },
  "updateExistingContacts": true,
  "emptyContactsAttributes": true
}

Response

Contact import request has been accepted

processIdinteger required

Id of the process created

Example response

{
  "processId": 78
}