Create Free Bets
Create a free bet campaign for a player.
⚠️ These endpoints are available only for whitelisted IP addresses.
POST /free-bets/create
POST{provider endpoint}/free-bets/create
Create a new free bet campaign for a player on a specific game.
Request
Headers: X-Server-Authorization: hmac_sha256_hash
{
"playerId": "player_777",
"game": "firefruit-sevens-classic",
"count": 10,
"amount": 20.50,
"currency": "eur",
"walletId": "777casino-platform",
"operatorId": "777casino-uk",
"startTime": "2024-12-10T13:45:00.000Z",
"endTime": "2025-12-10T13:45:00.000Z"
}
Request Parameters
| Field | Type | Description | |
|---|---|---|---|
| playerId | string | required | Operator's unique identifier for the player receiving the free bets |
| game | string | required | Game identifier the free bets are valid for |
| count | integer | required | Number of free bet spins to award |
| amount | number | required | Bet amount per free spin, in the specified currency |
| currency | string | required | ISO 4217 currency code for the free bets (e.g. eur, pln) |
| walletId | string | required | Platform wallet identifier, provided by NeverEnding |
| operatorId | string | required | Your operator identifier |
| startTime | string (ISO 8601) | required | Campaign start date/time. Format: YYYY-MM-DDTHH:mm:ss.sssZ |
| endTime | string (ISO 8601) | required | Campaign expiry date/time. Free bets cannot be used after this time. Format: YYYY-MM-DDTHH:mm:ss.sssZ |
Response
✓ 200 OK
{
"campaignId": "78481869-ea9d-4143-a629-92322eb5ce4d"
}
Response Parameters
| Field | Type | Description |
|---|---|---|
| campaignId | string (UUID) | Unique identifier for the newly created free bets campaign. Store this to cancel the campaign later via /free-bets/cancel |