Skip to content
Scheduling API

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
post.tsnode
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. 1

    Connect accounts

    Your customer signs in with each network's login. You get an account ID per profile, Page or channel.

  2. 2

    Make a key

    Create a key for that customer or agent with the accounts and caps it's allowed.

  3. 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.

RequestREST
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}
Response

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.

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
    Read the docs
  • 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
    Postkey with n8n
  • 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
    About the 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.