Create or Get user

​

Get or Create a user identified by their systemRef. Requires platform authentication with a secret key.

Body
required
application/json
  • systemRef
    Type: string
    required

    Reference ID from the SSO system

Responses
  • application/json
  • application/json
  • application/json
Request Example for post/api/v1/user
curl https://platform.youzu.ai/api/v1/user \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'x-client-secret: YOUR_SECRET_TOKEN' \
  --data '{
  "systemRef": ""
}'

{
  "user": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "systemRef": "string",
    "createdAt": "2026-04-12T12:10:23.016Z",
    "updatedAt": "2026-04-12T12:10:23.016Z"
  }
}

User retrieved/created successfully