Webhooks

Webhooks allow you to receive real-time notifications when events happen in your KeepFlow account.

Setting up webhooks

Configure webhook endpoints in your dashboard under Settings > Webhooks. Each endpoint receives a POST request with a JSON payload describing the event.

Event types

• `conversation.created` — New conversation started
• `conversation.resolved` — Conversation resolved
• `identity.detected` — New identity fingerprint detected
• `data.processed` — Data obfuscation job completed

Payload structure

{
  "event": "conversation.created",
  "timestamp": "2026-03-15T10:30:00Z",
  "data": { ... }
}

Verification

All webhook payloads include a `X-KeepFlow-Signature` header. Verify this signature using your webhook secret to ensure the request is legitimate.