Sign in
latestOpenAPI 3.1.02026-08-10466368560.6 KB

2b2bab8b9017

referral

Track Click

Track a referral click. This endpoint is public and does not require auth.

Used when a user visits a character/space/landing page with referral params.

post/referral/track-click

Request body

referral_codestring required

Referral code (e.g., REF-45WGQS) to identify the creator

content_typestring required

Type of content: character, space, landing

content_idstring uuid nullable

ID of the character/space if applicable

utm_sourcestring required

Traffic source: reddit, youtube, discord, etc.

utm_mediumstring nullable

Marketing medium: social, video, post, etc.

utm_campaignstring nullable

Campaign identifier

utm_contentstring nullable

Content variant for A/B testing

referrer_urlstring nullable

HTTP referer header

landing_urlstring nullable

URL the user landed on

visitor_fingerprintstring nullable

Browser fingerprint for deduplication

Response

Successful Response

trackedboolean required

Whether the click was tracked

uniqueboolean required

Whether this is a unique visitor within 24h window

click_idstring uuid nullable

ID of the created click record