Inbound CRM webhook | Pivolio Docs

Records a single event delivered by an inbound webhook, authenticated by the write key. When the workspace has a webhook signing secret, the request must also carry a valid X-Signature header (hex HMAC-SHA256 of the raw body).

Request

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

Response

Successful Response

okbooleanDefaults to true

event_idstring or null

duplicatebooleanDefaults to false

Errors

422

Unprocessable Entity Error

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