Webhooks

Webhooks send HTTP POST requests to your server when events occur in Keep'em. Use them to trigger actions in your systems without polling the API.

Setup

Configure webhook endpoints in Project Settings → Integrations → Webhooks. Provide a URL and select which events to subscribe to.

Events

Payload

{
  "event": "viewer.completed",
  "timestamp": "2025-01-15T14:30:00Z",
  "data": {
    "eventId": "evt_abc123",
    "registrationId": "reg_def456",
    "externalId": "your_user_id",
    "email": "viewer@example.com"
  }
}

Retries

Failed deliveries (non-2xx response) are retried with exponential backoff. After multiple failures, the webhook is marked as failed and visible in your dashboard.