Boost postbacks

When a player receives an active boost, TapResearch can notify your server via an HTTP postback.

Setup

Boosts need to be enabled for your app title by the TapResearch team, please reach out to your account manager when you are ready to get started.

Once enabled, set your Boost postback URL under Settings → App title boosts in the Publisher Dashboard. Use an HTTPS URL and test it before saving.

Overview

TapResearch sends active boosts to your endpoint as POST requests. Return a 2xx response to acknowledge receipt; failed requests are retried.

HTTP request

POST <your configured URL>

Property	Value
Content-Type	application/json

Payload

The body is a JSON array. Each element represents one app and contains the list of boosted players for that app.

[
  {
    "api_token": "YOUR_API_TOKEN",
    "players": [
      {
        "uid": "player-uid-123",
        "boost": {
          "start_date": "2026-03-17T12:00:00.000Z",
          "end_date": "2026-03-17T13:00:00.000Z",
          "boost_tag": "birthday_boost",
          "boost_display_name": "Birthday Bonus",
          "boost_multiplier": 2.0,
          "boost_expiration_date": null
        }
      }
    ]
  }
]

Payload fields

Field	Type	Description
api_token	String	The API token for the app the player belongs to
players	Array	List of boosted player objects for this app

Player object

Field	Type	Description
uid	String	The player's unique identifier
boost	Object	The active boost details

Boost object

Field	Type	Description
start_date	ISO 8601	When the boost became active (UTC)
end_date	ISO 8601	When the boost expires (UTC)
boost_tag	String	Internal tag identifying the boost type (e.g., "birthday_boost")
boost_display_name	String	User-facing name for the boost
boost_multiplier	Float	The multiplier applied to the player's rewards (e.g. 2.0 = 2x)
boost_expiration_date	ISO 8601	Expiration date for the boost record. Will be null if not applicable.

Response

Return a 2xx status code to confirm receipt.