RedRover Logo

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

EventSent when
post.scheduledA post is on the schedule with a date
post.postedA post went live. url holds the live link
post.failedA post could not be published or was removed. failureReason says why
post.needs_approvalA new post is waiting for your approval
post.cancelledA post was cancelled
comment.scheduledA comment is on the schedule with a date
comment.postedA comment went live. url holds the live link
comment.failedA comment could not be published or was removed. failureReason says why
comment.needs_approvalA new comment is waiting for your approval
comment.cancelledA comment was cancelled
review.note_addedSomeone 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.

comment.posted
{
  "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
  }
}
HeaderValue
RedRover-SignatureThe signature, see below
RedRover-EventThe event type, like post.posted
RedRover-Event-IdThe event ID, the same on every retry
RedRover-Delivery-IdThis 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.

  1. Read the raw request body as text, before any JSON parsing.
  2. Compute HMAC-SHA256 of the timestamp, a period, and the body, with your secret as the key.
  3. Compare it to v1 with a constant-time comparison.
  4. Reject requests whose t is more than 5 minutes from your clock, so a captured request cannot be replayed.
Node.js
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);
});
Python
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 "", 200

Delivery 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.

AttemptWhen
1Right away
21 minute later
310 minutes later
41 hour later
56 hours later
616 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"