Skip to main content
POST
Track page view
Required scopes: analytics.manage

Authorizations

Authorization
string
header
required

Use Authorization: Bearer rk_live_....

Headers

Idempotency-Key
string
required

A unique value for each new request, such as a UUID. Send the same value to retry a request safely. The same key and payload replay the first response with Idempotency-Replayed: true.

Required string length: 1 - 160

Body

application/json
external_event_id
string
required
Required string length: 1 - 200
session_id
string
required
Required string length: 1 - 500
page_url
string<uri> | null
referrer_url
string<uri> | null
user_agent
string | null
Maximum string length: 512
occurred_at
string<date-time>

ISO 8601 date-time with Z or a ±HH:MM offset. Stored as UTC.

device_type
enum<string> | null
Available options:
mobile,
desktop,
tablet
landing_id
string | null
Maximum string length: 150
landing_name
string | null
Maximum string length: 200
landing_slug
string | null
Maximum string length: 80

Omission preserves the existing implicit measurement behavior. Required mode needs an explicit grant.

Available options:
implicit,
required

False suppresses analytics recording.

Response

Event duplicate or idempotent replay returned.

event
object | null
required
duplicate
boolean
required
created
boolean
required
recorded_analytics
boolean

Whether this request recorded an analytics event.