Track

Track let's you build up a picture of your users. Data points on your users are called Traits. These are attributes you can derive insight from to drive decision making. /track provides the mechanism to record these attributes.

Track attributes

POST /track/:userId

Updates an existing user's traits.

Much like identifiers, traits use an append & merge approach. Properties will override an existing value if that key already, and any new properties will be added.

You do not need to send existing properties when updating, these will continue to be persisted (or overwritten per the above section). To remove a value, send the key and a null value. For example to remove lastPurchaseDate:

{
    ...
    "lastPurchaseDate": null
}

Headers

Name	Value
Content-Type*	application/json
Authorization*	Bearer <token>

Query

Name	Type	Description
:userId*	string	ID of the user. usr_[A-Za-z0-9]{16}

Body

Name	Type	Description
traits	object	An object containing identifying properties on the user

Response

200

{
  "id": "usr_XXX",
  "workspaceId": "ws_XXX",
  "identifiers": {},
  "traits": {},
  "createdAt": "2025-04-05T00:10:41.840Z",
  "updatedAt": "2025-04-09T10:06:06.813Z"
}

Important: Fields with a * must be included in your request!