---
title: "Track Click"
method: POST
path: "/referral/track-click"
tags: ["referral"]
---

# Track Click

`POST /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.

## Request body

- TrackClickRequest — Request body for tracking a referral click.
  - `referral_code` string, required — Referral code (e.g., REF-45WGQS) to identify the creator
  - `content_type` string, required — Type of content: character, space, landing
  - `content_id` string, uuid, nullable — ID of the character/space if applicable
  - `utm_source` string, required — Traffic source: reddit, youtube, discord, etc.
  - `utm_medium` string, nullable — Marketing medium: social, video, post, etc.
  - `utm_campaign` string, nullable — Campaign identifier
  - `utm_content` string, nullable — Content variant for A/B testing
  - `referrer_url` string, nullable — HTTP referer header
  - `landing_url` string, nullable — URL the user landed on
  - `visitor_fingerprint` string, nullable — Browser fingerprint for deduplication

## Response `200`

Successful Response

- TrackClickResponse — Response after tracking a click.
  - `tracked` boolean, required — Whether the click was tracked
  - `unique` boolean, required — Whether this is a unique visitor within 24h window
  - `click_id` string, uuid, nullable — ID of the created click record

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/meganova/apis/fastapi.md) · [All operations](https://skmtc.net/meganova/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meganova/fastapi/revisions/2b2bab8b9017/schema)