Generic webhook
Send Generic webhook alerts to on-call with CallHeim.
Any tool — post our canonical alert JSON directly. CallHeim maps the payload, collapses repeats within five minutes, and pages whoever is on call for the service it belongs to.
Setting it up
POST the canonical alert JSON (title/severity/body/dedupKey) directly to the webhook.
Create an Integration in CallHeim and choose Generic webhook from the Catalog. You get an ingest URL for that integration — paste it into Generic webhook’s webhook configuration. The snippet beside this is the shape it expects, with {{WEBHOOK_URL}} replaced by your real URL.
If you enable request signing on this integration, CallHeim requires a valid HMAC-SHA256 signature in the X-ItOnCall-Signature or X-Hub-Signature-256 header on every request to it. Without a signing secret, the ingest URL itself is the credential.
CallHeim includes a payload mapping for Generic webhook’s webhook format, built and tested against sample payloads.
# Any system — POST canonical JSON:
curl -X POST "{{WEBHOOK_URL}}" \
-H 'content-type: application/json' \
-d '{"title":"...","severity":"P2","body":"...","dedupKey":"..."}'After it arrives
What CallHeim does with Generic webhook alerts.
Anything that can POST a JSON object can raise an alert. A no-code mapping (dot and bracket paths — a JSONPath subset, not the full spec) picks out the fields you care about, and the alert joins the same pipeline as every catalogued source.
CallHeim maps Generic webhook’s own severity to a P1–P5 level and shows a separate, explainable severity suggestion — a published keyword ruleset plus your own resolved-incident history — that a person can apply. How severity is suggested →
Each alert source is bound to a service, and the service’s escalation policy (or its team’s) sets who is paged. Alerting and escalation →
CallHeim closes an incident on a recovery event only for sources whose recovery payload it recognises (or that you map). For the others, a person resolves the incident.
The thresholds it passes through
- Dedup window
- 300s
- Flap threshold
- 4 transitions / 600s
- Title correlation
- similarity ≥ 0.6, same source and service
- Group window default
- 600s
All defaults are published. You can turn title correlation off or change its threshold, and set the window on your own noise rules; the dedup window and the flap settings are fixed. How alerts are processed →
Point Generic webhook at CallHeim and see what it does with your alerts.
Explore the platform, connect one source, and send yourself a test page by e-mail (early access).
Early access · every workspace starts with a 14-day trial for up to 5 seats, no card required