API reference

Tracking

Record clicks from the browser.

Record a click

POST/v1/clicksno scope

Records a referral click. Called by the tracking script — you rarely call this directly.

Body parameters

programSubdomainreqstringIdentifies the program.
referralCodereqstringFrom `?ref=`.
visitorIdreqstringFirst-party visitor id.
destinationUrlstring
referrerUrlstring
utmSourcestring
utmMediumstring
utmCampaignstring

Response

json
{ "clickId": "4b91..." }
  • Unauthenticated by necessity — it runs in a visitor's browser, where any key would be public. The program is identified by subdomain and rate-limited by IP.
  • Persist the returned `clickId` and send it with the conversion for the most accurate attribution.