Webhooks
Round Robin Social tells your server when something happens, with a signed JSON POST.
Events
Webhooks are set per brand under Workspace settings, Developers, Webhooks. For now Round Robin turns them on: write to hello@roundrobin.in with the brand and your address. They cover these events: post.published, post.failed, post.scheduled, post.not_live, comment.received, dm.received, approval.requested, approval.approved and approval.changes_requested. The address must use https. Each event is a JSON POST:
{ "id": "evt_...", "type": "post.published", "createdAt": "2026-11-02T05:00:03.000Z", "brandId": 1, "data": { "post": { ... } } }
Check the signature
Check the X-RRS-Signature header before trusting it: t=<unix seconds>,v1=<hex>, where hex is the HMAC-SHA256 of t + "." + the raw body with the endpoint's secret. Refuse a t more than five minutes old.
const [t, v1] = header.split(",").map((p) => p.split("=")[1]);
const expected = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
const ok = crypto.timingSafeEqual(Buffer.from(v1), Buffer.from(expected)) && Date.now() / 1000 - Number(t) < 300;
Answers and retries
Answer with any 2xx within 10 seconds. Anything else is tried again after 1 minute, 5 minutes, 30 minutes, 2 hours and 6 hours. After 15 failed attempts in a row the webhook is turned off and Activity says so. The delivery log shows every attempt and can send one again. The same event can arrive twice: use its id to skip repeats.