Help CenterIntegrations

Using webhooks

🔌 Integrations
4 min

Using webhooks

Get notified on the URL of your choice when things happen.

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.

More in Integrations

Still need help?

We typically reply within 24 hours.

Contact support