User identification

Use this REST resource to create new users or update the data of existing tracked users.

API domain:

Create or update user

Resource: POST /v1/identify

"user": {
    "username": "a-unique-user-identifier", // REQUIRED, must be unique
    "firstname": "", // optional
    "lastname": "", // optional
    "role": "", // optional
    "signUpAt": "2020-07-08T00:00:00", // optional, JSON Date/DateTime format must be used
    "props": { // optional custom properties
        "intCustomProp": 78878,
        "boolCustomProp": false,
        "stringCustomProp": "example",
        "arrayCustomProp": [1, 2, 3]

This endpoint upserts the given tracked user. Use it to sync user properties from your backend systems. This call can also trigger a real-time update of the Product Fruits content if the user is online.