Scheduling Posts via API

Written by Grant - Postpone Founder
Updated 1 week ago

First, read through Postpone's API introduction article to learn how to work with the Postpone API playground and make API calls.

Scheduling Posts for Reddit

To schedule Reddit posts via API, use the following GraphQL mutation:

mutation createRedditPost(
  $redditUsername: String!
  $title: String!
  $content: String
  $link: String
  $mediaName: String
  $comment: String
  $submissions: [SubmissionInput]!
  $sendRepliesToInbox: Boolean
  $nsfw: Boolean
) {
  createRedditPost(
    redditUsername: $redditUsername
    title: $title
    content: $content
    link: $link
    mediaName: $mediaName
    comment: $comment
    submissions: $submissions
    sendRepliesToInbox: $sendRepliesToInbox
    nsfw: $nsfw
  ) {
    success
    errors
    validationErrors {
      code
      message
    }
  }
}

Pass the following variables to the query:

{
    "redditUsername": "YOUR_USERNAME",
    "title": "This is a post",
    "content": "",
    "link": "https://google.com",
    "mediaName": "",
    "comment": "",
    "submissions": [
        {
            "subreddit": "python",
            "postAt": "2025-10-05T14:30",
            "flairId": ""
        },
        {
            "subreddit": "webdev",
            "postAt": "2025-10-05T14:30",
            "flairId": ""
        }
    ],
    "sendRepliesToInbox": true,
    "nsfw": false
}

Scheduling Posts for Other Platforms

To schedule posts for other platforms, refer to the API Playground and search for the following platform-specific schedule mutations:

  • Twitter: scheduleTweet
  • Instagram: scheduleInstagramPost
  • Facebook: scheduleFacebookPost
  • Threads: scheduleThreadsPost
  • Bluesky: scheduleBlueskyPost
  • TikTok: scheduleTikTokPost
  • YouTube Shorts: scheduleYouTubePost
  • LinkedIn: scheduleLinkedInPost
  • Pinterest: schedulePinterestPost
  • Mastodon: scheduleMastodonPost
  • Tumblr: scheduleTumblrPost

Did this answer your question?