Creates a new bonus offer or updates an existing one within the Gamanza Engage platform (Upsert)
PUT/rx-api/bonus-offer/v1/offer/:bonusOfferId
This endpoint allows operators to seamlessly synchronize their catalog of bonus offers with Gamanza Engage. It is designed to act as an idempotent upsert (update or insert) operation, relying on the operator's own unique identifier (bonusOfferId) as the source of truth.
- Create (Insert): If the {bonusOfferId} does not currently exist within the Gamanza Engage database, the system will ingest the payload and create a brand-new bonus offer.
- Update: If a bonus offer associated with the {bonusOfferId} already exists, the system will overwrite the existing configuration with the new data provided in the request body.
By maintaining an up-to-date catalog of the operator's available bonuses via this endpoint, Gamanza Engage can effectively link these external bonus offers to internal platform features, such as gamification mechanics (e.g., mission rewards, tournament prizes, or loyalty shop items) and targeted CRM campaigns.
Request
Responses
- 202
- 400
- 401
- 500
- default
Accepted
400 (BAD REQUEST) error with some field in the request
401 Unauthorized
500 (Error) Internal server Error
An unexpected error response.