Core Concepts
Webhooks
Get a signed request the moment your content is scheduled, goes live, fails or needs your approval, instead of polling.
Add an HTTPS endpoint with Create a Webhook Endpoint or from the Developers page in RedRover, pick the events you want, and store the signing secret it returns. Each workspace can have up to 10 endpoints. Managing webhooks needs an API key with the webhooks:read and webhooks:write scopes.
Events
| Event | Sent when |
|---|---|
post.scheduled | A post is on the schedule with a date |
post.posted | A post went live. url holds the live link |
post.failed | A post could not be published or was removed. failureReason says why |
post.needs_approval | A new post is waiting for your approval |
post.cancelled | A post was cancelled |
comment.scheduled | A comment is on the schedule with a date |
comment.posted | A comment went live. url holds the live link |
comment.failed | A comment could not be published or was removed. failureReason says why |
comment.needs_approval | A new comment is waiting for your approval |
comment.cancelled | A comment was cancelled |
review.note_added | Someone left a note on content waiting for approval, you or our team |
Payload
Every event has the same envelope. For post and comment events, data is the same object Get a Post returns, as it stood when we sent the event. For review.note_added, data holds contentId, contentType and the note.
{
"id": "e7a1c3f5-2b4d-4c6e-8f0a-1b3d5f7a9c2e",
"type": "comment.posted",
"apiVersion": "v1",
"createdAt": "2026-11-10T17:31:20Z",
"workspaceId": "8f14e45f-ceea-4e1a-9c2b-6d7a1c3b9e21",
"data": {
"id": "91574",
"type": "comment",
"status": "posted",
"title": null,
"body": "We batch ours on Thursdays and ship Friday morning. Keeps it honest.",
"subreddit": "startups",
"flair": null,
"threadUrl": "https://www.reddit.com/r/startups/comments/1abcde2/how_do_you_plan_content/",
"scheduledFor": "2026-11-10T17:30:00Z",
"postedAt": "2026-11-10T17:31:12Z",
"url": "https://www.reddit.com/r/startups/comments/1abcde2/comment/kx9z1p0/",
"upvotes": 14,
"commentCount": 2,
"failureReason": null,
"canChange": false
}
}| Header | Value |
|---|---|
RedRover-Signature | The signature, see below |
RedRover-Event | The event type, like post.posted |
RedRover-Event-Id | The event ID, the same on every retry |
RedRover-Delivery-Id | This endpoint's delivery of the event |
apiVersion changes only for breaking changes. New fields and new event types can appear at any time, so ignore what you do not recognize.
Verifying Signatures
Every request carries a RedRover-Signature header like t=1763222480,v1=5257a869e7.... t is the time we signed it, in Unix seconds. v1 is the hex HMAC-SHA256 of {t}.{raw body}, keyed with your endpoint's signing secret.
- Read the raw request body as text, before any JSON parsing.
- Compute HMAC-SHA256 of the timestamp, a period, and the body, with your secret as the key.
- Compare it to
v1with a constant-time comparison. - Reject requests whose
tis more than 5 minutes from your clock, so a captured request cannot be replayed.
import crypto from "node:crypto";
import express from "express";
const app = express();
const secret = process.env.REDROVER_WEBHOOK_SECRET;
// Verify against the raw body, before any JSON parsing.
app.post("/hooks/redrover", express.raw({ type: "application/json" }), (req, res) => {
const header = req.get("RedRover-Signature") ?? "";
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const timestamp = Number(parts.t);
const body = req.body.toString("utf8");
const expected = crypto
.createHmac("sha256", secret)
.update(`${timestamp}.${body}`)
.digest("hex");
const fresh = Math.abs(Date.now() / 1000 - timestamp) <= 300;
const valid =
fresh &&
typeof parts.v1 === "string" &&
parts.v1.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(parts.v1), Buffer.from(expected));
if (!valid) return res.status(400).send("Invalid signature");
const event = JSON.parse(body);
// Answer fast, then do the work.
res.sendStatus(200);
handleEvent(event);
});import hashlib
import hmac
import json
import os
import time
from flask import Flask, abort, request
app = Flask(__name__)
SECRET = os.environ["REDROVER_WEBHOOK_SECRET"].encode()
@app.post("/hooks/redrover")
def redrover_webhook():
header = request.headers.get("RedRover-Signature", "")
parts = dict(part.split("=", 1) for part in header.split(",") if "=" in part)
timestamp = int(parts.get("t", "0"))
body = request.get_data(as_text=True) # the raw body, before parsing
expected = hmac.new(SECRET, f"{timestamp}.{body}".encode(), hashlib.sha256).hexdigest()
fresh = abs(time.time() - timestamp) <= 300
if not fresh or not hmac.compare_digest(parts.get("v1", ""), expected):
abort(400)
event = json.loads(body)
handle_event(event)
return "", 200Delivery and Retries
We send each event within about a minute as an HTTPS POST with a JSON body. Answer with any 2xx status within 10 seconds. Anything else, a redirect, or no answer counts as a failure, and we try again.
| Attempt | When |
|---|---|
| 1 | Right away |
| 2 | 1 minute later |
| 3 | 10 minutes later |
| 4 | 1 hour later |
| 5 | 6 hours later |
| 6 | 16 hours later, about a day after the event |
Events can arrive more than once and out of order. Use the payload's id (also in the RedRover-Event-Id header) to skip events you already handled, and read data.status for the current state rather than relying on order.
Endpoints That Keep Failing
After 30 failed attempts in a row spanning more than a day, we turn the endpoint off and email your team. Fix it, check it with Send a Test Event, then turn it back on with Update a Webhook Endpoint. Events from while it was off are not resent.
See every attempt, its status code and error with List Webhook Deliveries. We keep 30 days of history.
Testing
Send a Test Event posts a signed webhook.test event to your endpoint right away and tells you how your endpoint answered.
curl -X POST "https://app.tryredrover.com/api/public/v1/webhooks/5d2f8a1c-4b6e-4f3a-9d7c-1e8b2a6f0c93/test" \
-H "Authorization: Bearer $REDROVER_API_KEY" \
-H "X-Workspace-Id: $REDROVER_WORKSPACE_ID"