Skip to content

Instagram Scheduling API

Queue Instagram posts, Reels, Stories and carousels for later, each under its own key.

  • Schedule feed post, reel, story and carousel 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_ig_123"
  ],
  content: "New colours just dropped. Which one's yours?",
  media: [
    {
      type: "image",
      url: "https://cdn.example.com/colours.jpg"
    }
  ],
  instagram: {
    format: "feed"
  },
  scheduledFor: "2026-12-01T09:00:00Z"
});
  • Instagramqueued

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

Schedule your first Instagram post

  1. 1

    Connect Instagram

    Your customer signs in through Instagram'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 Instagram at that time, and a webhook tells you how it went.

Every Instagram 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 Instagram sit under "instagram".

A single image post on the profile grid.

RequestREST
1POST https://api.postkey.dev/v1/posts2Authorization: Bearer pk_cust_42_…3Content-Type: application/json4 5{6  "accounts": [7    "acc_ig_123"8  ],9  "content": "New colours just dropped. Which one's yours?",10  "media": [11    {12      "type": "image",13      "url": "https://cdn.example.com/colours.jpg"14    }15  ],16  "instagram": {17    "format": "feed"18  },19  "scheduledFor": "2026-12-01T09:00:00Z"20}
Response

202 · scheduled

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

{
  "id": "post_3k9d2",
  "status": "scheduled",
  "scheduledFor": "2026-12-01T09:00:00Z",
  "results": [
    {
      "account": "acc_ig_123",
      "platform": "instagram",
      "status": "queued",
      "format": "feed"
    }
  ]
}

Everything you need for Instagram scheduling

  • Checked against Instagram's rules

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

    Caption length
    2,200 characterssource
    Hashtags
    Up to 30 per postsource
    Carousel items
    Up to 10 images or videossource
    Account type
    Business or Creator accounts onlysource
  • One extra field

    Every Instagram 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 Instagram's rules when you schedule, so problems show up now.

  • Four formats, one field

    Feed post, Reel, Story or carousel: set format and send the media. The rest of the request stays the same.

  • Professional accounts

    Instagram's API only publishes to Business and Creator accounts. Postkey tells you up front if a connected account can't be posted to.

Also for Instagram

PostingInstagram Posting APIPublish feed posts, Reels, Stories and carousels without building the Instagram API integration yourself.See the page

Keys & control

Every Instagram post has an owner

Each customer or agent posts to Instagram 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

Instagram scheduling questions

Something not here? Email hello@postkey.dev.

What can I publish to Instagram?

Feed posts, Reels, Stories and carousels. You pick one with the format field; the endpoint is the same.

Does it work with personal Instagram accounts?

No. Instagram's publishing API only works with professional accounts (Business or Creator). Switching is free in the Instagram app.

Why is my Reel 'processing' instead of 'posted'?

Instagram processes video before it publishes. The API call returns right away, and a webhook follows when the Reel is live or if Instagram rejects it, with the reason.

Do I need to host my media somewhere?

Instagram pulls media from a public URL. If you'd rather not host files, upload them to Postkey and it serves them for the publish step.

Can I post the same thing to Facebook and TikTok?

Yes. List more accounts in the same request. Each platform gets its own result, so one failure doesn't hide the others.

How do I schedule a Instagram 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 Instagram with a key per customer.

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