Agency Partners
Schedule a Post for a Client
Schedules a post for one client, with the same rules as Schedule a Post.
https://app.tryredrover.com/api/public/v1/clients/{client}/postsposts:writeNeeds a partner key; any other key or a connected AI app gets 403.
A sandbox key checks the post the same way, records it and answers with a simulated scheduled post. Nothing is published and no credits are used.
Headers
AuthorizationstringRequiredBearerfollowed by anrr_live_API key or a connected app's access token. See Authentication.
Path Parameters
clientstringRequiredThe client's workspace ID, or your own reference for it. A UUID is tried as an ID first
Body
titlestringRequiredThe post title
1 to 300 characters
bodystringRequiredThe post text
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
Response
201 The scheduled 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.
404No client with this ID or reference in your agency400A field is missing or invalid, or scheduledFor is too soon402The client doesn't have enough credits401The 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/clients/crm-1042/posts" \
-H "Authorization: Bearer $REDROVER_API_KEY" \
-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",
"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
}
}