RedRover Logo

Posts

Schedule a Post

Schedules a new post in a subreddit at least 5 minutes ahead.

POST/posts
Scope: posts:writeAI Connector Tool: redrover_schedule_post

Our 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

  • AuthorizationstringRequired

    Bearer followed by an rr_live_ API key or a connected app's access token. See Authentication.

  • X-Workspace-IdstringRequired

    The workspace to act on, from List Workspaces.

    UUID

Body

  • titlestringRequired

    The post title, up to 300 characters

    1 to 300 characters

  • bodystringRequired

    The post text, up to 40,000 characters

    1 to 40000 characters

  • subredditstringRequired

    The subreddit, with or without r/

    1 to 50 characters

  • flairstring

    Post flair, when the subreddit asks for one

    1 to 64 characters

  • scheduledFordatetimeRequired

    When it should go live, as an ISO 8601 datetime at least 5 minutes from now

Response

201 The post.

  • dataobjectRequired
    Show 15 Child Fields
    • idstringRequired

      Content ID. Content waiting for your approval has a UUID; scheduled content has a number

    • typestringRequired

      post or comment

      one of post, comment

    • statusstringRequired

      Where it stands

      one of draft, pending_approval, approved, scheduled, posted, failed, cancelled

    • titlestringRequired

      Post title. Null for comments

      nullable

    • bodystringRequired

      The text

      nullable

    • subredditstringRequired

      Subreddit, without r/

      nullable

    • flairstringRequired

      Post flair. Posts only

      nullable

    • threadUrlstringRequired

      Comments only: the thread the comment replies in

      nullable

    • scheduledForstringRequired

      When it is due to go live

      nullable

    • postedAtstringRequired

      When it went live

      nullable

    • urlstringRequired

      The live link once posted

      nullable

    • upvotesnumberRequired

      Upvotes once posted

      nullable

    • commentCountnumberRequired

      Replies once posted

      nullable

    • failureReasonstringRequired

      Why it failed or was removed, when it did

      nullable

    • canChangebooleanRequired

      Whether 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 away
  • 402The workspace doesn't have enough credits. The message says how many it needs and where to top up
  • 401The Authorization header is missing, or the key is invalid or revoked
  • 403The key lacks the endpoint's scope, or cannot reach the workspace
  • 429More than 120 requests in a minute. Wait for Retry-After seconds
  • 500Something 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"
}'
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
  }
}