webhooks5 min

Webhooks

Real-time event push into your warehouse, Slack or n8n.

Event types

•event.purchase · fired on every server-side purchase
•identity.stitched · fired the first time a profile is merged
•agent.alert · fired when an agent reaches the alert state
•agent.suggestion · fired when an agent proposes an action

Payload shape

POST https://your.endpoint
X-Traqly-Signature: t=1746940000,v1=••••••

{
  "type": "event.purchase",
  "workspace": "ws_demo",
  "data": { "id": "evt_...", "value": 149.0, "channel": "google" }
}

Signing

Verify the X-Traqly-Signature header with HMAC-SHA256 using your endpoint secret. The format mirrors Stripe's; sample code is shown in the SDKs doc.