API

Track install

Called by the SDK on first open as trackInstall(). Authorization is Bearer YOUR_TAPAPPLINK_KEY.

POST /ingestInstall

Request

Body may include platform, device family, locale, network context, install referrer, firstOpenAt, and a debugger session id.

{
  "platform": "IOS",
  "deviceFamily": "iPhone",
  "locale": "en_US",
  "networkContext": "US",
  "installReferrer": "optional-play-referrer",
  "firstOpenAt": "2026-08-27T12:00:00.000Z"
}

Response

{
  "matched": true,
  "attributionId": "...",
  "offer": {
    "creatorName": "Sarah",
    "promoCode": "SARAH10",
    "billingOfferId": "sarah_tiktok"
  }
}