---
title: "Track visitor event"
method: POST
path: "/public/tracking/event"
tags: ["Tracking - Public"]
---

# Track visitor event

`POST /public/tracking/event`

Track visitor event from frontend.
Uses background task for fire-and-forget performance.

## Headers

- `x-website-token` string, nullable

## Request body

- TrackEventRequest
  - `visitor_id` string, required — Unique visitor identifier (UUID)
  - `event_type` string, required — Event type: page_view, form_submit, click, scroll, engagement
  - `page_url` string, required — Current page URL
  - `page_title` string, nullable — Page title
  - `event_name` string, nullable — Specific event name
  - `metadata` object, nullable — Additional event data
  - `utm` UTMParams
    - `utm_source` string, nullable
    - `utm_medium` string, nullable
    - `utm_campaign` string, nullable
    - `utm_term` string, nullable
    - `utm_content` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/multigest/apis/multigest-protected-api.md) · [All operations](https://skmtc.dev/multigest/apis/multigest-protected-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/multigest/multigest-protected-api/revisions/4b44eb76b3ee/schema)