RedRover Logo

Get Started

Quickstart

Make your first request and schedule a post in about five minutes.

1. Create an API Key

Open the Developers page in RedRover and click Create API Key. Name it, pick the workspaces it can reach and the scopes it needs. For this guide, give it posts:read and posts:write.

Copy the Key Now

The full key is shown once. Store it in a secret manager or an environment variable, never in code or a browser.

Terminal
export REDROVER_API_KEY="rr_live_..."

2. Find Your Workspace

Every request acts on one workspace. List the ones your key can reach and copy an id.

curl "https://app.tryredrover.com/api/public/v1/workspaces?limit=25" \
  -H "Authorization: Bearer $REDROVER_API_KEY"
200 Response
{
  "data": [
    {
      "id": "8f14e45f-ceea-4e1a-9c2b-6d7a1c3b9e21",
      "name": "Acme Analytics"
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "hasMore": false
  }
}
Terminal
export REDROVER_WORKSPACE_ID="8f14e45f-ceea-4e1a-9c2b-6d7a1c3b9e21"

3. Read Your Scheduled Posts

Send the workspace in the X-Workspace-Id header.

curl "https://app.tryredrover.com/api/public/v1/posts?status=scheduled&limit=25" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID"

4. Schedule a Post

Pick a subreddit and a time at least 5 minutes from now. The API answers 201 with the new post, which then appears in your RedRover calendar.

curl -X POST "https://app.tryredrover.com/api/public/v1/posts" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "What we learned shipping a weekly changelog for a year",
  "body": "We started writing a public changelog every Friday. Here is what changed for us...",
  "subreddit": "r/startups",
  "flair": "Lessons Learned",
  "scheduledFor": "2026-12-01T15:00:00Z"
}'
201 Response
{
  "data": {
    "id": "48213",
    "type": "post",
    "status": "scheduled",
    "title": "What we learned shipping a weekly changelog for a year",
    "body": "We started writing a public changelog every Friday. Here is what changed for us...",
    "subreddit": "startups",
    "flair": "Lessons Learned",
    "threadUrl": null,
    "scheduledFor": "2026-12-01T15:00:00Z",
    "postedAt": null,
    "url": null,
    "upvotes": null,
    "commentCount": null,
    "failureReason": null,
    "canChange": true
  }
}

Next Steps