PlanSched API

The PlanSched API gives 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 Twitter/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.