Identify users

📘

Legacy Tracker Documentation

For the legacy tracker doc, check our guide here.

This endpoint creates and updates users directly on the Brevo account. You can use the cURL request below to send a request:

curl --request POST \
     --url https://in-automate.brevo.com/api/v2/identify \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'ma-key: YOUR_MA_KEY'
     --data '
{
  "email": "[email protected]",
  "attributes": {
    "FirstName": "abc",
    "LastName": "def",
    "Age": 24,
    "SMS": 919989894562
  }
}
'

Parameters are defined below:

AttributeDatatypeDescriptionValue
emailStringEmail address used to identify a user[email protected]
attributesJSON ObjectContains your custom fields. These user properties will populate your contact databaseSee example above

Response

Response codeMessageDescription
204User has been identified and successfully updatedResponse shown in case of creation and user update
400Bad requestThis error is shown in case of a bad request involving invalid_parameter, missing_parameter and out_of_RangeModel

What’s Next