Skip to main content
POST
Report site events straight from the browser (publishable key, no response body)

Path Parameters

projectId
string
required

The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.

Minimum string length: 1
Example:

"prj_01kv60qgnef2kt3pvqgwmkbzfr"

Query Parameters

key
string
required

The application’s publishable key, pk_…, from the dashboard’s API Access screen. It is public by design and may only send events, from the origins listed on the application. An API key is never accepted here (401).

Example:

"pk_01k7q3x9h4e8rb2d6m0z5a7c1n"

Body

The batch of events, as JSON. Sent as text/plain by a beacon.

events
object[]
required

The events, at most 50 per beacon (and 64 KB in all). The same shapes as POST /events; each is validated on its own and a rejected one never fails the batch.

Required array length: 1 - 50 elements

One site event. type picks the shape; the fields every type shares are listed on each.

Example:

Response

The beacon was read; accepted events are recorded. No body.