Quick Start

Get your first monitor running in under 2 minutes. Sign in, generate an API key, exchange it for a bearer token, and create your first webpage monitor.

1. Get a bearer token

Sign in, go to Settings → API Keys, and create a key. You'll receive a Client ID — the only value with the dh_live_ prefix — and a Client secret (opaque string without that prefix).

Exchange them for a bearer token:

Use the returned access_token in the Authorization: Bearer <token> header on all requests. Tokens expire after 24 hours — see Authentication for the full flow.

2. Create a monitor

3. Receive change events

When content changes, DiffHook POSTs to the URL in notification_config.webhook_url for that monitor, or to your workspace default webhook if you did not set a per-monitor override:

{
  "event": "page.changed",
  "monitor_id": "mon_abc123",
  "url": "https://competitor.com/pricing",
  "triggered_at": "2026-03-16T14:22:00Z",
  "content": "Pro plan: $59/month — …"
}

4. Test it manually

You can trigger an immediate check at any time:

Next steps

• Scope monitoring — add a css_selector to ignore nav/footer noise
• Pause when not needed — use /pause and /resume to stay within your plan's monitor usage
• Verify signatures — authenticate incoming webhooks with the signing secret