If you have many custom user properties to attach all at once, you can use this API.

This API has the same endpoint as Add User Properties. The only difference is that it takes a users array of objects, with a max of 1000 users per request.

curl \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
  "app_id": "12345",
    "identity": "[email protected]",
    "properties": {
      "Role": "Admin",
      "Vertical": "Ecommerce",
      "email": "[email protected]"
   {"identity": "[email protected]",
    "properties": {
      "Role": "User",
      "Vertical": "Saas",
      "email": "[email protected]"
  }' \



If you want to write your user's email into the built-in Email property, you must send the key lowercase as per the example above.

Sending an email value with a non-lowercase key will create a new property to store this data.


Please note: fetch, jQuery, and XMLHttpRequest options are not currently supported.

Did you find what you were looking for?
Thumb up Thumb down