Webhooks integration
Signed outbound webhooks the moment a tracked change is detected.
Webhooks are for the team that has its own internal automation layer — a workflow engine, a Zapier-style platform, or a custom service that already routes signals across the company. Instead of polling the REST API on a timer, point us at a URL and we will deliver every detected event there as it happens, signed so your handler can verify it came from us.
What it does
- Outbound HTTPS POST per detected event, with retries on 5xx (exponential backoff up to 24 hours, then a final dead-letter notification).
- HMAC-SHA256 signature in the x-ci-signature header so your endpoint can verify the payload was not tampered with in transit.
- Idempotency key in x-ci-event-id — safe to retry on your side without double-processing.
- One subscription per environment (production, staging) with the same payload shape, so you can wire a test endpoint first.
- Filter by severity and event type at the subscription level so a noisy endpoint stays quiet.
Payload shape
One event per request. Every detected change ships with the same envelope, so a handler can switch on event.type without tracking schema versions per change category.
POST https://your-app.example.com/competitor-intel
content-type: application/json
x-ci-signature: t=1714060800,v1=4f0a2b…
x-ci-event-id: evt_2c91…
{
"event_id": "evt_2c91a8b4f3",
"delivered_at": "2026-04-25T09:00:00Z",
"workspace_id": "ws_8f3a",
"competitor": {
"id": "cmp_a7b2",
"name": "Acme Corp",
"domain": "acme.example.com"
},
"event": {
"type": "pricing_change",
"severity": "high",
"confidence": 0.92,
"title": "Acme raised Pro tier from $29 to $39/mo",
"summary": "Pricing page now shows the Pro plan at $39/mo.",
"detected_at": "2026-04-25T08:54:00Z",
"source_url": "https://acme.example.com/pricing"
}
}How to set it up
Webhooks are in private beta. The implementation is shipping — payload shape, signature, and retry behaviour are stable — but we are admitting workspaces in batches so we can hand-hold the first few integrations.
- 1Email us at hello@competitorintelligence.co with the URL of the endpoint you want to deliver to and the events you want to receive.
- 2We add your workspace to the beta and share the signing secret over a secure channel.
- 3Verify the first event in your handler logs, then flip the subscription from staging to production from the dashboard.
Available on the Growth plan and above.
See pricing →Add a competitor in two minutes.
First material change typically lands Under 24h. No credit card. Public sources only.