Award vote reward | FluxStore Docs

POST/api/v1/loyalty/vote-reward

Award loyalty points for one or more votes. Points are calculated as pointsPerVote × count using the value configured in your store’s Loyalty Rewards settings.

This is the REST option for awarding vote rewards. The FluxStore plugin’s Votifier integration is the usual path. See the plugin protocol for how votes are delivered automatically.

Awarding vote rewards 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 who voted.

playerUuidstring

The player’s UUID, if known.

countinteger

Number of votes to award for. Defaults to 1.

sourcestring

Optional identifier for the vote source.

idempotencyKeystring

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

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

POST/api/v1/loyalty/vote-reward


curl -X POST \
  -H "X-Api-Key: flx_XXXX_XXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "playerUsername": "Steve",
    "playerUuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
    "count": 1,
    "source": "minecraft-mp.com",
    "idempotencyKey": "vote-2026-06-06-steve"
  }' \
  https://api.fluxstore.net/api/v1/loyalty/vote-reward

200OK


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