Introduction
Scheduling Posts via API
The Postpone API provides powerful GraphQL mutations to schedule posts across multiple social media platforms. This comprehensive guide will walk you through the process of scheduling posts programmatically.
Overview
Postpone supports scheduling posts to the following platforms through dedicated GraphQL mutations:
Platform-Specific Mutations
Each platform has its own dedicated GraphQL mutation for scheduling posts. Here's a quick reference:
| Platform | Mutation Name | Description |
|---|---|---|
scheduleRedditPost | Schedule posts to multiple subreddits | |
| X/Twitter | scheduleTweet | Schedule tweets and threads |
scheduleInstagramPost | Schedule feed posts, Reels, and Stories posts | |
scheduleFacebookPost | Schedule posts to Pages | |
| Threads | scheduleThreadsPost | Schedule posts to Threads |
| Bluesky | scheduleBlueskyPost | Schedule posts to Bluesky |
| TikTok | scheduleTikTokPost | Schedule video content |
| YouTube Shorts | scheduleYouTubePost | Schedule short-form videos |
scheduleLinkedInPost | Schedule professional posts | |
schedulePinterestPost | Schedule pins to boards | |
| Mastodon | scheduleMastodonPost | Schedule posts to Mastodon |
| Tumblr | scheduleTumblrPost | Schedule posts to Tumblr |
Common Parameters
While each platform has specific requirements, most scheduling mutations share common parameters:
READY_TO_PUBLISH, DRAFT (default: READY_TO_PUBLISH).Response Format
All scheduling mutations return a consistent response structure:
{
success: Boolean!
errors: [ValidationError]
}
Common Errors
These errors are commonly encountered across multiple platforms when scheduling posts:
The specified username is not connected to your Postpone account. Connect the social media account in your settings first.
The postAt timestamp must be in the future. Check your timezone settings and ensure the date is correct.
Your post content exceeds the platform's character limit. Each platform has different limits - check the platform-specific documentation for details.
You've reached your plan's posting limit for the scheduled month. Upgrade your plan or schedule for a different month.
The media file exceeds the platform's size limits. Each platform has different file size restrictions - optimize your media or check platform limits.
The media format is not supported by the target platform. Check the platform's supported file types and convert if necessary.
Some platforms don't allow combining certain content types (e.g., polls with media, text with links). Choose one content type per post.
Best Practices
When using the scheduling API, keep these best practices in mind:
Each platform has its own rate limits. Space out your API calls appropriately to avoid hitting these limits.
Ensure your postAt timestamps are in the future and properly formatted in ISO 8601 format (e.g., 2025-09-16T14:30:00.000Z).
Always check the response for errors and validation issues. Implement proper error handling in your application.
Use the API playground to test your mutations before implementing them in your application.
Getting Started
To begin scheduling posts via the API:
Connect Your Accounts
Ensure you have connected the social media accounts you want to post to in your Postpone dashboard.
Obtain API Credentials
Get your API token from the Postpone dashboard to authenticate your requests.
Choose Your Platform
Select the platform you want to schedule posts for and refer to the platform-specific documentation.
Test Your Integration
Use the API playground to test your mutations before implementing them in production.
Next Steps
Ready to start scheduling posts? Choose a platform from the list above to see detailed examples and platform-specific requirements.