Contact ManagementContacts

Export contacts

It returns the background process ID which on completion calls the notify URL that you have set in the input. File will be available in csv.

Authentication

api-keystring

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

Request

Values to request a contact export
customContactFilterobjectRequired
Set the filter for the contacts to be exported.
disableNotificationbooleanOptionalDefaults to false

To avoid generating the email notification upon contact export, pass true

exportAttributeslist of stringsOptional

List of all the attributes that you want to export. **These attributes must be present in your contact database. It is required if exportMandatoryAttributes is set false. ** For example: [‘fname’, ‘lname’, ‘email’]

exportMandatoryAttributesbooleanOptionalDefaults to true

To export mandatory attributes like EMAIL, ADDED_TIME, MODIFIED_TIME

exportMetadatalist of stringsOptional

Export metadata of contacts such as _listIds, ADDED_TIME, MODIFIED_TIME.

exportDateInUTCbooleanOptionalDefaults to false
Specifies whether the date fields createdAt, modifiedAt in the exported data should be returned in UTC format.
exportSubscriptionStatuslist of stringsOptional

Export subscription status of contacts for email & sms marketting. Pass email_marketing to obtain the marketing email subscription status & sms_marketing to retrieve the marketing SMS status of the contact.

notifyUrlstringOptionalformat: "url"
Webhook that will be called once the export process is finished. For reference, https://help.brevo.com/hc/en-us/articles/360007666479

Response

process id created
processIdlong
Id of the process created

Errors