---
title: "Track Event"
method: POST
path: "/iap/events"
tags: ["Events"]
---

# Track Event

`POST /iap/events`

Tracks an analytics event from the SDK. Used for funnel analysis, screen views, and custom events.

## Request body

- object
  - `event_type` string, required — The event type identifier (e.g., `paywall_shown`, `purchase_started`, `checkout_completed`).
  - `user_id` string, required — The user's external ID.
  - `product_id` string — The product related to this event, if applicable.
  - `screen_name` string — The screen or view where the event occurred.
  - `metadata` object — Additional key-value metadata for the event.

## Response `201`

Event recorded

- object
  - `status` string

## Other responses

- `400` — Invalid request -- missing or malformed parameters.
- `401` — Invalid or missing API key.

---

[API](https://skmtc.net/zerosettle/apis/zerosettle-iap-api.md) · [All operations](https://skmtc.net/zerosettle/apis/zerosettle-iap-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerosettle/zerosettle-iap-api/revisions/1a7aa12f3d5e/schema)