---
title: "Track Onboarding Event"
method: POST
path: "/onboarding/track-event"
tags: ["Onboarding"]
---

# Track Onboarding Event

`POST /onboarding/track-event`

Track a specific onboarding funnel event for an authenticated user.
Example steps: first_student_home, teacher_pending_approval_viewed.

## Request body

- TrackOnboardingEvent
  - `step` string, required
  - `device_type` string, nullable
  - `onboarding_session_id` string, nullable
  - `context` object

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/excellence-ai/excellence-learning/revisions/8d495ed916c6/schema)