Inbound integration event

Records a single event delivered by an integration (Shopify, an inbound webhook, …), authenticated by that integration’s own write key.

A first-party SDK write key (not tied to an integration) is rejected here — it belongs on /track / /batch.

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 /ingest/integration \
>	-H "Content-Type: application/json" \
>	-d '{
>	"event_id": "01F8MECHZX3TBDSZ7XRADM79XE",
>	"event_name": "order_completed",
>	"event_time": 1686806400,
>	"anonymous_id": "anon-7f9c2ba4-3d1e-4a2b-9f3e-2d5a1c6b8e9f"
>	}'