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.
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"{
"data": [
{
"id": "8f14e45f-ceea-4e1a-9c2b-6d7a1c3b9e21",
"name": "Acme Analytics"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"hasMore": false
}
}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"
}'{
"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
}
}