Contact ManagementContacts

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.

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Request

Values to import contacts in Brevo. To know more about the expected format, please have a look at https://help.brevo.com/hc/en-us/articles/209499265-Build-contacts-lists-for-your-email-marketing-campaigns

disableNotificationbooleanOptionalDefaults to false
To disable email notification
emailBlacklistbooleanOptionalDefaults to false
To blacklist all the contacts for email
emptyContactsAttributesbooleanOptionalDefaults to false
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 **)
fileBodystringOptional
**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.
fileUrlstringOptionalformat: "url"

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

jsonBodylist of objectsOptional
**Mandatory if fileUrl and fileBody is not defined.** JSON content to be imported. **Maximum allowed json body size is 10MB** . However we recommend a safe limit of around 8 MB to avoid the issues caused due to increase of json body size while parsing. Please use fileUrl instead to import bigger files.
listIdslist of longsOptional

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

newListobjectOptional
To create a new list and import the contacts into it, pass the listName and an optional folderId.
notifyUrlstringOptionalformat: "url"
URL that will be called once the import process is finished. For reference, https://help.brevo.com/hc/en-us/articles/360007666479
smsBlacklistbooleanOptionalDefaults to false
To blacklist all the contacts for sms
updateExistingContactsbooleanOptionalDefaults to true
To facilitate the choice to update the existing contacts

Response

process id created
processIdlong
Id of the process created

Errors

400
Bad Request Error