Social Media Scheduling API
Queue posts for X, Instagram, Facebook, TikTok, LinkedIn, YouTube, Pinterest and Google Business at an exact time. Every scheduled post stays tied to the key that made it.
- Add one field to any post to schedule it
- Exact times in ISO 8601, no guessing
- Reschedule or cancel until it goes out
- Same limits, log and webhooks as instant posts
const pk = new Postkey(process.env.POSTKEY_KEY);
await pk.posts.create({
content: "Doors open at 9. See you there.",
accounts: [
"acc_ig_123",
"acc_li_456",
"acc_x_789"
],
media: [
{
type: "image",
url: "https://cdn.example.com/launch.png"
}
],
scheduledFor: "2026-12-01T09:00:00Z"
});- Instagramqueued
- LinkedInqueued
- Xqueued
Queued for Dec 1, 09:00 UTC · key customer_42
Three steps to your first scheduled post
- 1
Connect accounts
Your customer signs in with each network's login. You get an account ID per profile, Page or channel.
- 2
Make a key
Create a key for that customer or agent with the accounts and caps it's allowed.
- 3
Schedule
Send the post with scheduledFor. It's queued now and published at that time, with a webhook per platform.
One request, one clear response
The same request as posting now, plus a time. The response tells you it's queued, per platform.
1POST https://api.postkey.dev/v1/posts2Authorization: Bearer pk_cust_42_…3Content-Type: application/json4 5{6 "content": "Doors open at 9. See you there.",7 "accounts": [8 "acc_ig_123",9 "acc_li_456",10 "acc_x_789"11 ],12 "media": [13 {14 "type": "image",15 "url": "https://cdn.example.com/launch.png"16 }17 ],18 "scheduledFor": "2026-12-01T09:00:00Z"19}202 · scheduled
Queued under customer_42. Each platform gets a webhook when it goes out.
{
"id": "post_4d7a1",
"status": "scheduled",
"scheduledFor": "2026-12-01T09:00:00Z",
"results": [
{
"account": "acc_ig_123",
"platform": "instagram",
"status": "queued"
},
{
"account": "acc_li_456",
"platform": "linkedin",
"status": "queued"
},
{
"account": "acc_x_789",
"platform": "x",
"status": "queued"
}
]
}What the scheduling API handles for you
One extra field
Any post becomes a scheduled post with scheduledFor. Formats, media and options are the same as posting now.
Change your mind
Move the time or cancel the post with one call, any time before it goes out.
Checked when queued
Text and media are checked when you schedule, so you find problems now, not at 9am on launch day.
Queue per key
List what a customer or agent has scheduled. Each key only sees its own queue.
Logged both times
The activity log shows when a post was scheduled and when it actually went out, under the same key.
Off switch covers the queue
Turn a key off and its scheduled posts don't go out. Nothing slips through later.
Scheduling API for every platform
Each platform has its own page with the formats, the rules Postkey checks, and a request you can copy.
- X Scheduling APIText · Image · Video · Thread
- Instagram Scheduling APIFeed post · Reel · Story · Carousel
- Facebook Scheduling APIText · Photo · Video
- TikTok Scheduling APIVideo · Photo
- LinkedIn Scheduling APIText · Image · Document
- YouTube Scheduling APIVideo
- YouTube Shorts Scheduling APIShort
- Pinterest Scheduling APIPin
- Google Business Scheduling APIUpdate post · Offer · Event
Keys & control
The part other posting APIs leave to you. Every customer or agent posts through its own key, with limits, a log and an off switch.
- Scoped keysA separate key for each customer or AI agent.How it works
- Limits & kill switchCaps per key, duplicate blocking, one-call off switch.How it works
- Activity logWhich key posted what, when, and what happened.How it works
- WebhooksA result per platform, with a plain reason on failure.How it works
Works with your stack
Your code
Node and Python SDKs with the same calls, or plain REST from anything that speaks HTTP.
- Node
- Python
- {}REST
No-code tools
Call the REST API from an HTTP step in n8n, Make or Zapier. Give each workflow its own key.
- n8n
- Make
- Zapier
AI agents & MCP
The MCP server lets Claude, Cursor and other agent tools post through their own key, with caps they can't change.
- MCP server
Scheduling API questions
Something not here? Email hello@postkey.dev.
How do I schedule a post?
Send the normal post request with a scheduledFor time in ISO 8601 (UTC or with an offset). The response says it's scheduled.
Can I cancel or move a scheduled post?
Yes, until it goes out. Cancel it or send a new time with one call.
Do scheduled posts count against limits when queued?
Limits apply to the key that scheduled the post. A disabled key's queue doesn't go out.
Which platforms support scheduling?
All of them: X, Instagram, Facebook, TikTok, LinkedIn, YouTube, YouTube Shorts, Pinterest and Google Business.
What if the platform rejects it at publish time?
You get a webhook for that platform with a plain reason and whether a retry can help. The other platforms still go out.
What does it cost?
Scheduling is included. You pay for posts sent, same as posting now. See the pricing page.
Schedule the post. Keep the key in charge.
Get a key, connect an account, send your first request.
Free to start. Read the docs