Create a webhook
Settings → Webhooks → + Webhook.
- URL to POST to
- Events (e.g.
contact.created,deal.won,invoice.paid) - Secret (we generate one; use it to verify signatures)
Verifying signatures
We sign every request with HMAC-SHA256. Header: x-bbp-signature.
import { createHmac, timingSafeEqual } from "crypto";
const expected = createHmac("sha256", process.env.BBP_SECRET).update(rawBody).digest("hex");
if (!timingSafeEqual(Buffer.from(req.headers["x-bbp-signature"]), Buffer.from(expected))) {
return res.status(401).send("Invalid signature");
}
Retries
Failed deliveries retry with exponential backoff: 1m, 5m, 30m, 2h, 6h, 12h, 24h. Then we mark the webhook failing.
Logs
Settings → Webhooks → Logs shows every delivery with the response body and timing.