---
title: "User Identification"
url: "https://help.productfruits.com/en/article/rest-api-user-identification"
language: "en"
last_updated: "2026-08-24T11:10:21.161Z"
---

# User Identification

Use this REST resource to create new users or update the data of existing tracked users. Helpful when needing to update users in mass and [batch update](https://help.productfruits.com/en/article/tracked-users-batch-update) isn't an option. However, it's likely easier to send the majority of the data over the frontend via [the user information object](https://help.productfruits.com/en/article/identifying-users) when Product Fruits

**API domain**: api.productfruits.com

* * *

## Create or update user

**Resource**: POST /v1/identify  
**Body**

```
{
  "user": {
    "username": "a1b2c3d4e5f6", // REQUIRED, must be unique
    "firstname": "", // optional
    "lastname": "", // optional
    "role": "SALARY_ADMIN", // optional
    "email": "user@example.com", // 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]
    }
  },
  "group": { // optional
    "groupId": "12345"
  }
}
```

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.