Postpone API Documentation
Create scripts and automations using Postpone's GraphQL API to schedule posts across multiple social media platforms. Build powerful social media management tools with our comprehensive API.
import requests from .mutations import SCHEDULE_REDDIT_POST variables = { 'input': { 'username': 'myreddituser', 'title': 'Hello Reddit!', 'submissions': [ { 'subreddit': 'programming', 'postAt': '2026-09-16T14:30:00.000Z', } ], } } response = requests.post( 'https://api.postpone.app/gql', headers={'Authorization': 'Bearer YOUR-API-KEY'}, json={'query': SCHEDULE_REDDIT_POST, 'variables': variables} ) data = response.json()
Core API Features
Multi-Platform Scheduling
Schedule posts to Reddit, X/Twitter, Instagram, Facebook, TikTok, YouTube, LinkedIn, Pinterest, Mastodon, Bluesky, Threads, and Tumblr.
GraphQL API
Modern GraphQL API with powerful queries and mutations. Type-safe, efficient, and easy to explore with the built-in playground.
AI Agents & MCP
Connect AI tools to Postpone with the Model Context Protocol server. Schedule and manage posts using natural language, with OAuth or Bearer token authentication.
Media Support
Upload and attach images, videos, and other media to your posts. Support for galleries and Content Library integration.
Flexible Scheduling
Schedule posts for any future date and time. Perfect for content planning, automation, and maintaining consistent posting schedules.
Comprehensive Error Handling
Detailed error responses with validation errors and specific error codes help you build robust integrations.
Supported Platforms
Automate your social media presence across 12 social platforms.
Schedule posts to multiple subreddits with custom timing, flair selection, and more.
X/Twitter
Schedule tweets with media attachments and thread support.
Schedule photo and video posts with captions and hashtags.
Schedule posts to Facebook Pages.
Threads
Schedule posts to Meta's Threads platform.
Bluesky
Schedule posts to the decentralized Bluesky network.
TikTok
Schedule video content to TikTok.
YouTube Shorts
Schedule short-form video content to YouTube.
Schedule professional posts to LinkedIn profiles and pages.
Schedule pins to Pinterest boards.
Mastodon
Schedule posts to Mastodon instances.
Tumblr
Schedule posts to Tumblr blogs.