Muster.

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.

ℹ
Webhooks are a Team-plan integration. Deliveries retry up to 3 times with backoff on network errors, HTTP 429, and 5xx; a 4xx is treated as a permanent config error and isn't retried. Every attempt is logged (you can see the last delivery status in the dashboard).

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.

scan.completed
{
  "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"
}
findings.new
{
  "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.

verify (Node)
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();
});
⚠
Respond 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.