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