Record user level event

POST

api/v1/rewards/user/{userKey}/levels

Records a level progression event for a user and updates their experience and level status.

Idempotency Key
Always generate a unique idempotencyKey per logical action
Reusing the same idempotencyKey will prevent duplicate point records

This is especially important when:

Retrying failed requests

Handling network timeouts

Processing webhook or background jobs

Best practice:
Use a UUID (e.g. 550e8400-e29b-41d4-a716-446655440000) as the idempotencyKey.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'api/v1/rewards/user/{{user-key}}/levels' \
--header 'x-api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "idempotencyKey": "{{$string.uuid}}",
  "companyId": "c8e815c6-5d28-489e-a0eb-b0aa735b8c57",
  "userKey": "1765133168894",
  "levelId": "68eaaa5970611bf7f00bc411",
  "amount": 10,
  "actionSource": 2
}'

Response Example

{
    "id": "86",
    "userLevelId": "27",
    "amount": 564,
    "actionSource": 2,
    "date": "2025-08-11",
    "idempotencyKey": "1765133168894-68eaaa5970611bf7f00bc411-1766359559294"
}

Modified at 2025-12-23 15:34:14

Get Specific user point

Get user levels