Webhooks

Set up webhooks for real-time notifications

Updated 1/21/2026

Webhooks

Receive real-time notifications when events occur in your knowledge base.

Supported Events

Event	Description
`article.created`	New article published
`article.updated`	Article content changed
`article.deleted`	Article removed
`search.performed`	User searched (aggregated)

Setup

Create a Webhook

Go to Settings > Webhooks
Click "Add Webhook"
Enter your endpoint URL
Select events to subscribe to
Save

Verify Signature

We sign all webhooks with HMAC-SHA256:

const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Payload Format

{
  "event": "article.created",
  "timestamp": "2024-01-15T10:00:00Z",
  "data": {
    "article": {
      "id": "abc123",
      "title": "New Article",
      "slug": "new-article"
    }
  }
}

Retry Policy

Failed webhooks are retried:

3 attempts with exponential backoff
After 3 failures, webhook is disabled
Email notification sent to admins