Profile

Set Attribution

POST /api/v1/profile/attribution — persist first-touch install attribution.

Write-once: after attribution_captured_at is set the record is immutable, so re-syncs from the app (or replays) can't overwrite first-touch.

post/api/v1/profile/attribution

Request

  • Base URL: https://api.gemstoneaiapp.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.gemstoneaiapp.com/api/v1/profile/attribution
  • Auth: HTTP bearer

Request body

sourcestring nullable

utm_source / referrer source

mediumstring nullable

utm_medium

campaignstring nullable

utm_campaign / ct token

refstring nullable

ref shortcode from deep links

captured_atstring date-time nullable

When the client first captured this

Response

Successful Response

capturedboolean required
attribution_sourcestring nullable
attribution_mediumstring nullable
attribution_campaignstring nullable
attribution_refstring nullable
attribution_captured_atstring date-time nullable

Changes

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