Measurement ingest

​

GET / POST /ingest/:vendor

​

Authentication

• secret query parameter — per-vendor shared secret, compared in constant time. Requests with a missing or wrong secret get 401.
• app_token query parameter — the vendor app token; FloKit maps it to your workspace server-side.
• An optional per-vendor IP allowlist can additionally restrict callers.

​

Adjust callback URL

https://ingest.flokitai.com/ingest/adjust?secret=<ADJUST_CALLBACK_SECRET>
  &app_token=<token>
  &event_token={event_token}&activity_kind={activity_kind}&created_at={created_at}
  &os_name={os_name}&country={country}&adid={adid}&idfa={idfa}&gps_adid={gps_adid}
  &revenue={revenue}&currency={currency}&user_id={FloKit user id partner param}

• Vendor event tokens are translated to canonical FloKit event types via your workspace’s mapping configuration. Unmapped event tokens are dropped, counted in the dropped field.
• created_at becomes the event’s occurred_at (Unix seconds or ISO 8601 accepted); events with a missing or invalid created_at are dropped.
• os_name is normalized to ios / android; country is uppercased.
• revenue, currency, event_token, and activity_kind are preserved in the event’s properties.
• Device identifiers (adid, idfa, gps_adid) and the FloKit user_id partner parameter are carried for identity joining.

​

Example

curl "https://ingest.flokitai.com/ingest/adjust?secret=$ADJUST_CALLBACK_SECRET&app_token=abc123token&event_token=g3mz3t&activity_kind=event&created_at=1750500000&os_name=ios&country=us&adid=1a2b3c&revenue=49.99&currency=USD&user_id=usr_abc123"

// Typically Adjust calls this endpoint directly. For testing:
const params = new URLSearchParams({
  secret: process.env.ADJUST_CALLBACK_SECRET!,
  app_token: 'abc123token',
  event_token: 'g3mz3t',
  activity_kind: 'event',
  created_at: '1750500000',
  os_name: 'ios',
  country: 'us',
  user_id: 'usr_abc123',
});

const res = await fetch(
  `https://ingest.flokitai.com/ingest/adjust?${params}`,
);

const outcome = await res.json();
// { received: 1, written: 1, duplicate: 0, dropped: 0 }

​

Response

{
  "received": 1,
  "written": 1,
  "duplicate": 0,
  "dropped": 0
}

​

Deduplication

​

Errors

​

GET /healthz

{ "status": "ok" }