SchedPilot
Social Media API for Post Creation
Get your API key → Free 7-day trial. API access on every plan.
One POST creates a post on X/Twitter, LinkedIn, Instagram, Facebook, TikTok, YouTube, Threads, Bluesky, or Pinterest — scheduled for a date and time you choose, or published immediately.
curl -X POST https://api.schedpilot.com/developers/v1/post \
-H "X-API-KEY: $SCHEDPILOT_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": "Release 2.4 is out.",
"date": "2026-08-11",
"time": "09:30",
"timezone": "Europe/London",
"accounts": [{"id": 1234, "type": "twitter"}]
}'Every field on the create endpoint
| Field | Required | What it does |
|---|---|---|
content |
Yes | The post text. Limits vary by network — 280 characters on X/Twitter. |
accounts |
Yes | Array of {"id", "type"} objects. Both values come from GET /accounts. |
date + time |
Yes* | YYYY-MM-DD and 24-hour HH:mm. Not required if post_instant is true. |
post_instant |
No | true publishes now and ignores date/time. |
timezone |
No | IANA name, e.g. America/New_York. Defaults to UTC. |
attachments |
No | Media IDs from the upload endpoint: ["image-42"]. |
replies |
No | X/Twitter only. Posts a thread — or your first comment — right after the main post. |
Get the account IDs first
curl -H "X-API-KEY: $SCHEDPILOT_KEY" \
https://api.schedpilot.com/developers/v1/accountsReturns each connected account’s id, type, name, and username. Pass both id and type back in accounts — the type is required, not optional.
One call, several networks
Put more than one object in accounts and the same content goes to each. Threads and first comments are X/Twitter-only via replies; other networks ignore that field rather than failing.
Limits, stated plainly
30 write requests per hour, per user, on a rolling window — roughly 720 scheduled posts a day. Reads are 60/hour. Exceeding either returns 429 with a clear message. See Rate Limits and Error Handling.
Or let an agent call it
Install schedpilot-mcp, set SCHEDPILOT_TOKEN, and create_post becomes a tool your AI agent can use directly — same endpoint, no client code.
API access is included on every plan, from $21/month for 5 accounts to $79/month for 100 accounts and 10 team seats.