Track an event | Pivolio Docs

Records a single event from a browser or server SDK using the workspace write key, then queues it for enrichment and delivery.

This endpoint expects an object.

event_idstringRequired

Unique event ID (ULID)

event_namestringRequired

Event name (page_view, order_completed, etc.)

event_timedoubleRequired

Event timestamp (Unix seconds)

anonymous_idstringRequired

Anonymous visitor ID

schema_version"1"OptionalDefaults to 1

Schema version

user_idstring or nullOptional

Known user ID after identify

traitsobject or nullOptional

User traits (email, phone, etc.)

contextobject or nullOptional

Event context.

propertiesmap from strings to any or nullOptional

Event properties

test_modebooleanOptionalDefaults to false

Whether event is in test mode

Successful Response

okbooleanDefaults to true

event_idstring or null

duplicatebooleanDefaults to false

422

Unprocessable Entity Error

$	curl -X POST https://host.com/track \
>	-H "Content-Type: application/json" \
>	-d '{
>	"event_id": "string",
>	"event_name": "string",
>	"event_time": 1.1,
>	"anonymous_id": "string"
>	}'