PlanSched API

Preview spec — REST API not yet live

The REST endpoints on this page describe the planned developer surface at api.plansched.com. That host is not accepting requests yet. To integrate today, use the MCP server — it's live at plansched.com/mcp and ships three OAuth-gated tools: list_workspaces, list_posts, create_post.

The PlanSched API will give developers programmatic access to everything the PlanSched platform can do — build integrations, automate posting workflows, connect AI agents, or embed scheduling capabilities directly into your own products.

What you can do

Post to social accounts — publish or schedule content to X, LinkedIn, Instagram, Facebook, Threads, Bluesky, Pinterest, YouTube, and TikTok from a single API call.
Manage media — upload images and videos once, then attach them to any post by ID.
Schedule posts — specify a future date, time, and timezone; PlanSched handles delivery at the right moment.
Retrieve and filter posts — list your scheduled queue, filter by status or date range, and inspect per-platform delivery results.
Delete scheduled posts — cancel posts that have not yet been published.
Get analytics — pull impressions, reach, clicks, likes, comments, shares, and engagement rate.
Set up webhooks — receive real-time HTTP callbacks when posts are published, fail, or change status.
Connect AI agents — designed to work well as a tool in LLM-powered workflows via API keys or MCP.

Base URL

All API endpoints are available under:

https://api.plansched.com/developers/v1/

Every path in this documentation is relative to that base URL. For example, POST /post is called at https://api.plansched.com/developers/v1/post.

Quick start

Get from zero to your first scheduled post in three steps.

Step 1 — Get an API key

Sign in to the PlanSched dashboard, open Developer settings, and create a new API key. Copy the key immediately — it will only be shown once.

Authorization: Bearer sp_live_xxxxxxxxxxxxxxxxxxxx

Step 2 — Fetch your connected accounts

Every post must target one or more social accounts. Grab their IDs:

curl https://api.plansched.com/developers/v1/accounts \
  -H "Authorization: Bearer $PLANSCHED_KEY"

Step 3 — Create your first post

Publish immediately, or set a scheduled_at timestamp in the future.

curl -X POST https://api.plansched.com/developers/v1/post \
  -H "Authorization: Bearer $PLANSCHED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_ids": ["acc_123"],
    "text": "Hello from the PlanSched API 🚀",
    "scheduled_at": "2026-08-01T15:30:00Z"
  }'

Next steps

Explore the API Reference — endpoint-by-endpoint details for accounts, posts, media, analytics, and webhooks.
Set up webhooks — stream delivery events into your systems in real time.
Connect an AI agent via MCP — plug PlanSched into Claude, Cursor, or any MCP-compatible client.

Authentication → API Keys

Continue →