All Uses

Social Media Scheduling API

Updated July 28, 2026

Get your API key →  Free 7-day trial. API access on every plan.

SchedPilot’s scheduling API takes one POST and publishes to X/Twitter, LinkedIn, Instagram, Facebook, TikTok, YouTube, Threads, Bluesky, and Pinterest at the date and time you specify, in the timezone you specify.

curl -X POST https://api.schedpilot.com/developers/v1/post \
  -H "X-API-KEY: $SCHEDPILOT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Ship notes are live.",
    "date": "2026-08-04",
    "time": "09:30",
    "timezone": "Europe/London",
    "accounts": [
      {"id": 1234, "type": "twitter"},
      {"id": 5678, "type": "linkedin"}
    ]
  }'

One call, two platforms, scheduled. Drop date and time and set post_instant: true to publish immediately.

The endpoints

Endpoint Does
GET /developers/v1/accounts Your connected accounts, with the id and type you pass to the post endpoint
POST /developers/v1/post Schedule or publish immediately
GET /developers/v1/posts List posts, filter by status or date range
DELETE /developers/v1/posts/{id} Cancel a scheduled post
POST /developers/v1/media/upload Upload an image or video, returns a "type-id" for attachments
GET /developers/v1/analytics/{id} Performance for a published post
Webhooks Get notified when a post publishes or fails

Auth in one header

Send X-API-KEY with your key from app.schedpilot.com/api-access, or use OAuth 2.0 with a Bearer sp_tok_… token if you are publishing on behalf of other users. Both are documented in Authentication.

Rate limits, stated up front

60 read requests and 30 write requests per hour, per user, on a rolling window. That is roughly 720 scheduled posts a day. If you are bulk-importing a back catalogue, spread the writes or talk to us first — we would rather size it with you than have you hit a 429 in production.

Same API, wired to an AI agent

Install schedpilot-mcp, set SCHEDPILOT_TOKEN, and any MCP-compatible agent gets the same six operations as tools. Your agent writes the post and schedules it without you building a client.

What it costs

API access is on every plan. $21/month for 5 accounts and 450 posts, $35/month for 20 accounts and unlimited posts, $49/month for 40 accounts, $79/month for 100 accounts and 10 team seats — annual billing, seven-day free trial. There is no separate developer tier and no per-profile surcharge.

Get your API key →  |  Read the docs  |  Pricing

Grow your social presence with the best tool for creating content

Schedule posts, find your best time to publish, and keep your calendar full — without the chaos. SchedPilot makes consistency simple across every channel.

Start for free

Free trial available. Cancel anytime.