Skip to content

Facebook Scheduling API

Queue Facebook Page posts for later. Each one is logged under the key that scheduled it.

  • Schedule text, photo and video posts
  • Exact times in ISO 8601
  • Reschedule or cancel until it goes out
  • Same limits, log and webhooks as posting now
post.tsnode
const pk = new Postkey(process.env.POSTKEY_KEY);

await pk.posts.create({
  accounts: [
    "acc_fb_page_456"
  ],
  content: "Our spring hours start Monday: 8am to 6pm.",
  facebook: {
    link: "https://example.com/hours"
  },
  scheduledFor: "2026-12-01T09:00:00Z"
});
  • Facebookqueued

Queued for Dec 1, 09:00 UTC · key customer_42

Schedule your first Facebook post

  1. 1

    Connect Facebook

    Your customer signs in through Facebook's own login. You get an account ID, never a password.

  2. 2

    Make a key

    Create a key for that customer or agent, scoped to their accounts, with the caps you choose.

  3. 3

    Schedule

    Add scheduledFor to the same request. It goes to Facebook at that time, and a webhook tells you how it went.

Every Facebook format, one endpoint

Pick a format to see the exact request with a publish time and what comes back. Options that only make sense on Facebook sit under "facebook".

A text post, with an optional link preview.

RequestREST
1POST https://api.postkey.dev/v1/posts2Authorization: Bearer pk_cust_42_…3Content-Type: application/json4 5{6  "accounts": [7    "acc_fb_page_456"8  ],9  "content": "Our spring hours start Monday: 8am to 6pm.",10  "facebook": {11    "link": "https://example.com/hours"12  },13  "scheduledFor": "2026-12-01T09:00:00Z"14}
Response

202 · scheduled

Queued under customer_42. It goes to Facebook at the time you set.

{
  "id": "post_3k9d2",
  "status": "scheduled",
  "scheduledFor": "2026-12-01T09:00:00Z",
  "results": [
    {
      "account": "acc_fb_page_456",
      "platform": "facebook",
      "status": "queued"
    }
  ]
}

Everything you need for Facebook scheduling

  • Checked against Facebook's rules

    Before anything is sent, Postkey checks it against Facebook's published limits:

    Where it posts
    Facebook Pages, not personal profilessource
    Who can connect
    Someone who can manage the Pagesource
  • One extra field

    Every Facebook format you can post now can be scheduled with scheduledFor. Nothing else changes.

  • Move or cancel

    Change the time or cancel the post with one call before it goes out.

  • Checked when queued

    Text and media are checked against Facebook's rules when you schedule, so problems show up now.

  • Pages, not profiles

    Meta's API publishes to Facebook Pages. Postkey lists the Pages a person manages when they connect, and you post to the ones you choose.

  • Link previews

    Add a link and Facebook builds the preview card from the page's own tags. Nothing extra to send.

Also for Facebook

PostingFacebook Posting APIPost text, links, photos and video to Facebook Pages from your app, one key per customer or agent.See the page

Keys & control

Every Facebook post has an owner

Each customer or agent posts to Facebook through its own key: only its accounts, its own caps, its own log, and an off switch that touches nothing else.

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

Facebook scheduling questions

Something not here? Email hello@postkey.dev.

Can I post to a personal Facebook profile?

No. Meta's API only allows publishing to Pages. That's a Facebook rule, not a Postkey one.

What can I post to a Page?

Text posts with or without a link, photo posts and video posts.

Who needs to connect the Page?

Someone who manages the Page. They sign in with Facebook, pick the Pages, and you get an account ID for each.

Why does a video post say 'processing'?

Facebook processes video before it appears. The call returns right away and a webhook follows with the final result.

Can I post to Facebook and Instagram together?

Yes. Put both account IDs in one request. You get a separate result for each.

How do I schedule a Facebook post?

Send the normal post request with scheduledFor in ISO 8601 (UTC or with an offset). You can cancel or move it until it goes out.

Schedule to Facebook with a key per customer.

Get a key, connect an account, send the request above.