Webhooks

Receive near real-time signals about agent activity, API usage, and billing events.

Configure

Set your destination in the dashboard or via API:

POST /api/webhooks
{
  "url": "https://observability.acme.ai/zettagent",
  "events": ["agent.task.started", "agent.task.completed", "usage.threshold.reached"]
}

Event Schema

{
  "id": "evt_01HYZ8CM3R",
  "type": "agent.task.completed",
  "created": 1740785623,
  "data": {
    "taskId": "task_123",
    "agentId": "inspectors@acme",
    "durationMs": 4280,
    "tokens": 1534
  },
  "signature": "v1,b3dd7c...",
  "attempt": 1
}

All webhook payloads are signed with AUTH_SECRET. Verify using an HMAC SHA-256 digest of the raw body.