Webhooks API

Webhook endpoints can be managed from Dashboard → Integrations or via the API.

Register an endpoint

POST /api/workspace/integrations

Provide the HTTPS URL and the event types to deliver. The response includes the signing secret — store it like an API key; it is shown once.

List and remove endpoints

GET    /api/workspace/integrations
DELETE /api/workspace/integrations/:id

Payload shape

{
  "event": "operation.completed",
  "createdAt": "2026-06-10T09:14:03.000Z",
  "workspaceId": "...",
  "data": {
    "operationId": "...",
    "agentId": "...",
    "action": "INVOICE_MATCH",
    "status": "ok"
  }
}

Delivery guarantees

At-least-once delivery with exponential backoff for 24 hours. Build handlers to be idempotent on data.operationId, and verify the signature header before processing — see Webhooks for the verification flow.