Webhooks

Configure webhooks to receive real-time notifications about detected changes.

Setting Up Webhooks

1. Go to Settings → Notifications
2. Scroll to Webhooks section
3. Enter your webhook URL
4. Optionally configure a webhook secret for HMAC verification
5. Save your settings

Webhook Payload

When a change is detected, Competitor Watch sends a POST request to your webhook URL with a JSON payload:

{
  "event": "change.detected",
  "timestamp": "2024-01-15T10:30:00Z",
  "change": {
    "id": "change_id",
    "siteId": "site_id",
    "siteName": "Competitor Name",
    "changeType": "PRICING",
    "significance": "HIGH",
    "summary": "AI-generated summary of the change",
    "url": "https://competitor.com/changed-page"
  }
}

Webhook Security

If you configure a webhook secret, Competitor Watch signs each webhook payload with HMAC-SHA256. Verify the signature to ensure the request is authentic.

Testing Webhooks

Use a service like webhook.site to test your webhook configuration before using it in production.