developers
Webhooks
Receive signed JSON events at your own endpoint the moment a scan finishes or finds something — wire Muster into a SIEM, a ticketing flow, Zapier/Make, or anything that speaks HTTP.
Setup
Under an organization's Settings → Integrations, add a channel of type Webhook and paste your HTTPS endpoint. We generate a signing secret shown once — store it; you'll use it to verify every request.
Events
scan.completed— a scan finished; includes a findings tally by severity.scan.failed— a scan didn't complete; includes a reason when we have one.findings.new— a scan surfaced new findings.findings.regressed— previously-resolved findings came back.test— sent when you click “Test” on the channel.
Payload
Every request is a POST with a JSON body. The event and ts (ISO 8601) fields are always present; the rest depends on the event.
{
"event": "scan.completed",
"org": { "id": 1, "name": "Acme Inc.", "slug": "acme" },
"scan": { "target": "acme/api" },
"findings": { "total": 3, "by_severity": { "high": 1, "medium": 2 } },
"ts": "2026-08-11T22:14:05.000Z"
}{
"event": "findings.new",
"org": { "id": 1, "name": "Acme Inc.", "slug": "acme" },
"target": "acme/api",
"count": 2,
"findings": [
{ "title": "IDOR on /api/orders", "severity": "high", "type": "H001", "location_count": 1 }
],
"ts": "2026-08-11T22:14:05.000Z"
}Verifying the signature
Each request carries X-Muster-Signature: sha256=<hex>, an HMAC-SHA256 of the raw request body keyed by your signing secret, and X-Muster-Event with the event name. Compute the HMAC over the exact bytes you received (before JSON parsing) and compare in constant time.
import { createHmac, timingSafeEqual } from "node:crypto"; function verify(rawBody, header, secret) { const expected = "sha256=" + createHmac("sha256", secret).update(rawBody).digest("hex"); const a = Buffer.from(header || ""); const b = Buffer.from(expected); return a.length === b.length && timingSafeEqual(a, b); } // Express: use express.raw({ type: "application/json" }) so req.body is the raw Buffer. app.post("/hooks/muster", express.raw({ type: "application/json" }), (req, res) => { if (!verify(req.body, req.get("X-Muster-Signature"), process.env.MUSTER_WEBHOOK_SECRET)) { return res.status(401).end(); } const event = JSON.parse(req.body.toString()); // handle event.event … res.status(200).end(); });
2xx quickly (do slow work async). A non-2xx or a timeout is retried, so make your handler idempotent — dedupe on (event, ts, org.id) if you persist events.continue