Webhooks

Receive decisions and events in your own systems.

Webhooks send events to your endpoint as they happen, for example when an action is blocked, so you can alert a person or open a ticket.

POST /v1/webhooks
Authorization: Bearer sk_live_...
Content-Type: application/json

{
  "url": "https://example.org/hooks/cogna8",
  "events": ["gate_evaluation"]
}

Handling deliveries

Practice	Why
Respond quickly with a 2xx	Do slow work after acknowledging
Be idempotent	Use the event ID so a repeated delivery does no harm
Verify the sender	Only accept deliveries over HTTPS to an endpoint you control, and check the source before acting

Last reviewed October 2026Suggest a change