Developer guide
Webhooks: order, buyer and stock events
RapBooster webhooks POST a signed JSON event to your https endpoint when something happens in a workspace: an order is paid, shipped, delivered, cancelled or refunded, a buyer signs up or erases their account, a subscription changes, stock runs low, or an enquiry arrives. Verify the X-RapBooster-Signature header on the raw body and ignore an id you have already handled.
Guide
Step by step
Add an endpoint
In Settings › Developer › Webhooks add an https URL and pick its events. The signing secret is shown once. You can subscribe only to events whose records you may see yourself (order events need Store orders).
store.order.paid,store.order.shipped,store.order.delivered,store.order.cancelled,store.order.refundedstore.claim.created,store.review.submitted,store.subscription.changed,store.trade_account.appliedstore.buyer.created,store.buyer.deleted,store.cart.abandoned,inventory.stock.lowcrm.enquiry.created,hrms.application.created, plus the lead, message and social events
The payload
Every delivery is { id, event, created_at, data }. id is the same for every retry of one occurrence: store it and skip repeats. Order events carry number, status, buyer_id, metadata, total_minor, currency and lines (product_slug, price_id, qty); store.subscription.changed carries id, buyer_id, kind, plan_code, status and next_charge_at; store.buyer.deleted carries buyer_id (forget that buyer too).
A delivery
POST https://your-app.example/hooks/rapbooster
X-RapBooster-Event: store.order.paid
X-RapBooster-Signature: t=1795341600,v1=5f2c…
{
"id": "evt_9c1e…",
"event": "store.order.paid",
"created_at": "2026-11-17T10:00:00.000Z",
"data": {
"number": "CM-2026-27-0042",
"status": "paid",
"buyer_id": "12",
"total_minor": 64800,
"currency": "INR",
"metadata": { "source": "my-site" },
"lines": [{ "product_slug": "bikaneri-bhujia-400g", "price_id": "17", "qty": 2 }]
}
}Verify the signature
The signature is HMAC-SHA256 of <t>.<raw body> with your secret, hex encoded. While a rotated secret overlaps (24 hours) a delivery carries two v1= values. Refuse timestamps older than five minutes. Answer 2xx quickly; anything else is retried with growing gaps for 3 days.
Node (@rapbooster/sdk)
import { verifyWebhook } from "@rapbooster/sdk";
app.post("/hooks/rapbooster", express.raw({ type: "application/json" }), async (req, res) => {
const ok = await verifyWebhook({
body: req.body.toString("utf8"),
signature: req.get("X-RapBooster-Signature"),
secret: process.env.RAPBOOSTER_WEBHOOK_SECRET!,
});
if (!ok) return res.status(400).end();
const event = JSON.parse(req.body.toString("utf8"));
if (await seen(event.id)) return res.status(200).end();
await handle(event);
res.status(200).end();
});