Set Player Gameplay Limit

This endpoint allows you to set or update the maximum number of gameplays an individual player is allowed in a campaign. Use it when you want to control how many times a specific player can play — for example, granting extra attempts as a reward, or tightening the limit for a particular customer. The campaign must be configured with the dynamic gameplay limit type. Requests made against campaigns using any other gameplay limit type are rejected with a 400 response.

post/campaigns/{campaignId}/player-gameplay-limit

Request

  • Base URL
    https://gamify-api-us.optimove.net/adact
  • URL
    https://gamify-api-us.optimove.net/adact/campaigns/{campaignId}/player-gameplay-limit
  • Auth
    none required

Path parameters

campaignIdinteger required

The ID of the campaign you want to set the player gameplay limit for.

Request body

cidstring required

The Optimove customer ID of the player.

maxAllowedGameplaysCountinteger required

The maximum number of gameplays the player is allowed in this campaign. Must be 1 or greater.

Example request

{
  "cid": "user-abc-123",
  "maxAllowedGameplaysCount": 5
}

Response

200

object required

Changes

No recorded changes to this operation across all 1 revision of this API.