Send events
From your server
Trusted events from your backend, which can carry email and phone and link profiles.
Use server-side events for anything your backend knows for sure: orders, payments, shipping details, logins.
These events are trusted. They can carry email and phone, and when one event shows that two existing profiles are the same person, those profiles are merged.
Send server events#
POST https://<collector-host>/v1/events/authenticated collector token
Headers
Authorization string RequiredBearer $COLLECTOR_TOKENx-tenant-id string RequiredYour tenant.
x-workspace-id string Your workspace.
Content-Type string application/jsonThe body is newline-delimited JSON: one event per line, so you can send several events in one request. Keep each event on a single line; that's why the events below aren't pretty-printed.
curl -X POST "https://<collector-host>/v1/events/authenticated" \
-H "Authorization: Bearer $COLLECTOR_TOKEN" \
-H "x-tenant-id: breeze" -H "x-workspace-id: my-store" \
-H "Content-Type: application/json" \
--data-binary @- <<'EOF'
{"envelop_version":"1.0","id":"7c1e7a52-6f0e-4c0c-9a8b-2d4e6f8a0b1c","name":"addshippinginfo","tenant_id":"breeze","workspace_id":"my-store","anon_id":"cookie:3f9a1c7e","occured_at":"2026-10-08T10:14:12Z","properties":{"checkout_id":"CHK-88","country":"IN","identifiers":{"email":"[email protected]","cookie":"3f9a1c7e"}}}
{"envelop_version":"1.0","id":"0b6bd7e7-1a4b-4d12-8fd3-9f8f0f2a1b2c","name":"purchase","tenant_id":"breeze","workspace_id":"my-store","anon_id":"cookie:3f9a1c7e","occured_at":"2026-10-08T10:15:00Z","properties":{"order_id":"ORD-10421","amount":2499,"currency":"INR","identifiers":{"email":"[email protected]","phone":"+919812345678"}}}
EOF{
"filtered": 0,
"collected": 2,
"total": 2
}Response
collected number Events accepted for processing.
filtered number Events whose name isn't allowed by the collector's configuration.
total number Events in the request.