Posts
Schedule a Post
Schedules a new post in a subreddit at least 5 minutes ahead.
https://app.tryredrover.com/api/public/v1/postsposts:writeAI Connector Tool: redrover_schedule_postOur team handles publishing, so the post goes live on or shortly after scheduledFor. See Scheduling for the rules.
A post costs 32 credits, taken when it is scheduled. Cancelling it before it goes live gives them back. Check the balance with Get Credits.
Headers
AuthorizationstringRequiredBearerfollowed by anrr_live_API key or a connected app's access token. See Authentication.X-Workspace-IdstringRequiredThe workspace to act on, from List Workspaces.
UUID
Body
titlestringRequiredThe post title, up to 300 characters
1 to 300 characters
bodystringRequiredThe post text, up to 40,000 characters
1 to 40000 characters
subredditstringRequiredThe subreddit, with or without r/
1 to 50 characters
flairstringPost flair, when the subreddit asks for one
1 to 64 characters
scheduledFordatetimeRequiredWhen it should go live, as an ISO 8601 datetime at least 5 minutes from now
Response
201 The post.
dataobjectRequiredShow 15 Child FieldsHide Child Fields
idstringRequiredContent ID. Content waiting for your approval has a UUID; scheduled content has a number
typestringRequiredpost or comment
one of post, comment
statusstringRequiredWhere it stands
one of draft, pending_approval, approved, scheduled, posted, failed, cancelled
titlestringRequiredPost title. Null for comments
nullable
bodystringRequiredThe text
nullable
subredditstringRequiredSubreddit, without r/
nullable
flairstringRequiredPost flair. Posts only
nullable
threadUrlstringRequiredComments only: the thread the comment replies in
nullable
scheduledForstringRequiredWhen it is due to go live
nullable
postedAtstringRequiredWhen it went live
nullable
urlstringRequiredThe live link once posted
nullable
upvotesnumberRequiredUpvotes once posted
nullable
commentCountnumberRequiredReplies once posted
nullable
failureReasonstringRequiredWhy it failed or was removed, when it did
nullable
canChangebooleanRequiredWhether you can still edit, reschedule or cancel it
Errors
Every error uses the error envelope.
400A field is missing or invalid, or scheduledFor is less than 5 minutes away402The workspace doesn't have enough credits. The message says how many it needs and where to top up401The Authorization header is missing, or the key is invalid or revoked403The key lacks the endpoint's scope, or cannot reach the workspace429More than 120 requests in a minute. Wait for Retry-After seconds500Something went wrong on our side
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
}
}