Reward Configuration - Create

Creates a new reward configuration used for assigning free bets.

POST /api/v1/integration/reward-configurations/create

---

Request

Parameter	Type	Description	Required
name	String	Reward configuration name	Yes
status	String	Reward configuration status [ACTIVE, INACTIVE]	Yes
rewardType	String	Reward type [FREE_BET]	Yes
numberOfFreeBets	Integer	Number of free bets	Yes
startDate	Long	Start date in epoch milliseconds	No
endDate	Long	End date in epoch milliseconds	No
duration	Integer	Reward duration in minutes	Yes
games[]	Array	List of game reward configurations	Yes
games[].gameId	Integer	ID of the game eligible for the reward	Yes
games[].betConstraints	Object	Bet constraints per currency	Yes
games[].betConstraints.CURRENCY.betAmount	Decimal	Bet amount in the specified currency	Yes
games[].betConstraints.CURRENCY.maxWinPerBet	Decimal	Maximum win amount per bet in the specified currency	No
externalId	String	Merchant-defined identifier used to reference the reward configuration	No
merchantId	UUID	Merchant identifier	Yes
timestamp	Long	UNIX timestamp in milliseconds	Yes
hash	String	HMAC SHA256 signature used to verify the request	Yes

note

CURRENCY represents the ISO currency code (e.g. EUR, USD).

Example Request

{
  "name": "Free Bet Promo",
  "status": "ACTIVE",
  "rewardType": "FREE_BET",
  "numberOfFreeBets": 5,
  "startDate": 1754495931035,
  "endDate": 1757097931035,
  "duration": 60,
  "externalId": "promo-001",
  "games": [
    {
      "gameId": 1,
      "betConstraints": {
        "EUR": {
          "betAmount": 1,
          "maxWinPerBet": 100
        }
      }
    }
  ],
  "merchantId": "1387a6cc-3651-4473-ae52-e415caea3395",
  "timestamp": 1754495931035,
  "hash": "e93556d37a8c4eab7bda2d411322cdc4f0dc444c9101d9453a6635dfd8c73f7d"
}

---

Response

201 Created

note

The following fields are generated by the platform:

• id — reward configuration identifier
• games[].id — internal identifier of the game configuration

Example Response

{
  "id": "7a899322-c001-4187-8a8b-26d51d0e08fd",
  "name": "Free Bet Promo",
  "status": "ACTIVE",
  "rewardType": "FREE_BET",
  "numberOfFreeBets": 5,
  "startDate": 1754495931035,
  "endDate": 1757097931035,
  "duration": 60,
  "merchantId": "1387a6cc-3651-4473-ae52-e415caea3395",
  "games": [
    {
      "id": "f72cb8ef-10e6-4903-8735-369f6544a0a2",
      "gameId": 1,
      "betConstraints": {
        "EUR": {
          "betAmount": 1,
          "maxWinPerBet": 100
        }
      }
    }
  ]
}