---
title: "Record a consented, cookieless widget load or click"
method: POST
path: "/api/widgets/events"
---

# Record a consented, cookieless widget load or click

`POST /api/widgets/events`

## Request

- Base URL: `https://kunkafa.com`
- URL: `https://kunkafa.com/api/widgets/events`
- Auth: none declared

Optional measurement. Requires publisher consent. Approximate observed events, not unique visitors or verified installations. No cookies, account IDs, full URLs, queries or fragments. Requests are limited to 2 KiB. Activated only with the isolated collector release.

## Request body

- object
  - `id` string, uuid, required
  - `event` 'view' | 'click', required
  - `at` integer, required: Unix milliseconds; at most 2 hours late or 5 minutes future
  - `assets` string[], required
  - `layout` 'mini' | 'inline' | 'ticker' | 'vertical' | 'horizontal' | 'card' | 'strip' | 'board', required
  - `locale` 'en' | 'ar', required
  - `host` string, nullable
  - `path` string, nullable: Explicit public static path; sensitive or uncertain values discarded

## Response `204`

Accepted

## Other responses

- `400`: Invalid event
- `403`: Origin rejected
- `413`: Payload too large
- `429`: Admission cap reached
- `503`: Collector unavailable

---

[API](https://skmtc.dev/kunkafa/apis/kunkafa-public-data-and-integrations.md) · [All operations](https://skmtc.dev/kunkafa/apis/kunkafa-public-data-and-integrations/llms.txt) · [OpenAPI document](https://skmtc.dev/kunkafa/apis/kunkafa-public-data-and-integrations/revisions/8217b961f423?raw)