POST
/
api
/
identify
Identify a user or group
curl --request POST \
  --url http://localhost:3000/api/identify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "user": {
    "id": "user-1",
    "metadata": {
      "name": "John"
    }
  }
}'
{
  "user": "<string>",
  "group": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

User, group, or both to identify. Records are created for users or groups with appropriate metadata, or metadata is updated for existing users or groups. When a user is provided alongside a group, a link between the user and group is created.

Response

200 - application/json

Successful greeting response

The response is of type object.