Grant points | FluxStore Docs

POST/api/v1/loyalty/grant

Grant loyalty points to a player. The points are added to the player’s balance immediately.

Granting points requires the store to be on the Pro plan and Loyalty Rewards to be enabled. If loyalty is disabled or the subscription has lapsed, the request returns 403 Forbidden.

Body

playerUsernamestringrequired

The player to grant points to.

playerUuidstring

The player’s UUID, if known.

amountnumberrequired

Number of points to grant.

reasonstring

Optional reason logged against the grant.

idempotencyKeystring

Optional. Retries with the same key will not double-grant.

The data field is the player’s new balance after the grant.

POST/api/v1/loyalty/grant


curl -X POST \
  -H "X-Api-Key: flx_XXXX_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "playerUsername": "Steve",
    "playerUuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
    "amount": 100,
    "reason": "Event reward",
    "idempotencyKey": "event-2026-06-steve"
  }' \
  https://api.fluxstore.net/api/v1/loyalty/grant

200OK


{
  "success": true,
  "data": 600
}