---
title: "Track Event"
method: POST
path: "/api/track"
tags: ["Tracking"]
---

# Track Event

`POST /api/track`

Forward a frontend product event to PostHog.

The user's email is automatically attached as distinct_id; the front never
has to send it. Properties are passed through verbatim — keep them small
(PostHog truncates very large payloads).

## Request body

- TrackRequest
  - `event` string, required — PostHog event name (e.g. 'panel.opened')
  - `properties` object, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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