Instagram Posting API
Publish feed posts, Reels, Stories and carousels without building the Instagram API integration yourself.
- Feed posts, Reels, Stories and carousels
- Captions and media checked before Instagram sees them
- Business and Creator accounts, connected through Instagram's login
- A webhook when Instagram finishes processing video
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"
}
});- Instagrampublished
1 call · key customer_42
Your first Instagram post in three steps
- 1
Connect Instagram
Your customer signs in through Instagram's own login. You get an account ID, never a password.
- 2
Make a key
Create a key for that customer or agent, scoped to their accounts, with the caps you choose.
- 3
Post
Send the post to /v1/posts with that key. The Instagram result comes back in the response and by webhook.
Every Instagram format, one endpoint
Pick a format to see the exact request and what comes back. Options that only make sense on Instagram sit under "instagram".
A single image post on the profile grid.
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}200 · published
Counted against customer_42 only.
{
"id": "post_3k9d2",
"status": "published",
"results": [
{
"account": "acc_ig_123",
"platform": "instagram",
"status": "published",
"format": "feed",
"url": "https://www.instagram.com/p/…"
}
]
}Everything you need for Instagram posting
Checked against Instagram's rules
Before anything is sent, Postkey checks it against Instagram's published limits:
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.
Video processing tracked
Instagram processes Reels and video before publishing. Postkey waits for it and sends a webhook when the post is live or has failed.
Files or URLs
Instagram fetches media from a public URL. Send a URL, or upload the file to Postkey and it hosts it for the publish step.
Caps below Instagram's
Instagram limits how many API posts an account can publish in a day. Per-key caps stop one customer or agent from using up the whole allowance.
Also for Instagram
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
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
Beyond Instagram
Same request shape on every platform. Add an account ID and the post goes there too.
- X Posting APIText · Image · Video · Thread
- You're hereInstagram Posting APIFeed post · Reel · Story · Carousel
- Facebook Posting APIText · Photo · Video
- TikTok Posting APIVideo · Photo
- LinkedIn Posting APIText · Image · Document
- YouTube Posting APIVideo
- YouTube Shorts Posting APIShort
- Pinterest Posting APIPin
- Google Business Posting APIUpdate post · Offer · Event
Instagram posting 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.
Can I schedule Instagram posts instead?
Yes. Add scheduledFor to the same request. See the Instagram Scheduling API page for details.
Post to Instagram with a key per customer.
Get a key, connect an account, send the request above.
Free to start. Read the docs