Instagram API for scheduling posts, Reels, Stories, and carousels
Add Instagram publishing without turning your roadmap into a Meta Graph API maintenance project. bundle.social keeps the workflow simple while exposing the Instagram fields your product still needs.
Last updated: May 2026
1const response = await fetch("https://api.bundle.social/api/v1/post", {2 method: "POST",3 headers: {4 "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,5 "Content-Type": "application/json"6 },7 body: JSON.stringify({8 teamId: "team_123",9 title: "Instagram Reel",10 postDate: "2026-05-12T18:30:00.000Z",11 status: "SCHEDULED",12 socialAccountTypes: ["INSTAGRAM"],13 data: {14 INSTAGRAM: {15 type: "REEL",16 text: "Behind the scenes from launch week.",17 uploadIds: ["upload_reel"],18 shareToFeed: true19 }20 }21 })22});Instagram Graph API direct
What bundle.social handles
Instagram still has real account constraints
Instagram automation depends on the account type and permissions Meta gives you. We surface those rules up front so your team is not surprised in production.
Workflow
How it works
Connect accounts once, then create and schedule posts with channel-specific fields from one API.
Create an API key
Generate an organization API key in the dashboard and use it with the x-api-key header.
Connect accounts
Connect each social account once. bundle.social keeps the account mapping ready for future posts.
Create or schedule posts
Send one request with the publish date, selected channels, and the fields each platform needs.
Capabilities
Instagram publishing built for real production constraints
Posts, Reels, Stories, and carousels. The Meta Graph API complexity is handled for you.
Reels and feed posts
Schedule Instagram feed posts and Reels with upload IDs, captions, shareToFeed settings, and Reel-specific options.
Carousel support
Build carousels with multiple upload IDs and per-item metadata in a single post payload.
Stories where permitted
The Instagram schema supports STORY as a content type where account permissions and Meta eligibility allow it.
Alt text and accessibility fields
Include alt text and location metadata in the post payload so accessibility and discoverability details are never skipped.
Tags and collaborators
Add user tags and collaborator handles to supported Instagram content types through the same post creation workflow.
Analytics and audience demographics
Pull engagement data, import historical posts, and access raw audience demographics including age splits, city reach, and gender breakdown for connected Instagram accounts.
Content distribution at scale
Route Instagram posts across multiple connected accounts using the same API shape. Upload media once, reference it across campaigns, and track per-post status so failures don't cascade when volume increases.
Per-post error isolation
Each Instagram post tracks its own state independently. A single failed post surfaces its own error without blocking the rest of the publishing queue.
Platform specifics
Instagram API specifics for visual publishing
Instagram is strict about media shape, content type, and account connection details, so product teams should expose these constraints clearly.
Aspect ratios are strict
Reels and Stories should be vertical 9:16. Feed images usually need 4:5 or 1:1, while wider or taller content can fail or render poorly.
Auto-fit and auto-crop
For feed posts, autoFitImage can pad non-standard images and autoCropImage can center-crop them. They are mutually exclusive and do not apply to Reels or Stories.
Carousel item rules
Carousels support up to 10 items. Each carousel item must bind to one uploadId, and video carousel items do not support person tags.
Developer example
Schedule an Instagram Reel
Examples use bundle.social's public API shape: API key authentication, a post date, selected social account types, and platform-specific data.
1const response = await fetch("https://api.bundle.social/api/v1/post", {2 method: "POST",3 headers: {4 "x-api-key": process.env.BUNDLE_SOCIAL_API_KEY,5 "Content-Type": "application/json"6 },7 body: JSON.stringify({8 teamId: "team_123",9 title: "Instagram Reel",10 postDate: "2026-05-12T18:30:00.000Z",11 status: "SCHEDULED",12 socialAccountTypes: ["INSTAGRAM"],13 data: {14 INSTAGRAM: {15 type: "REEL",16 text: "Behind the scenes from launch week.",17 uploadIds: ["upload_reel"],18 shareToFeed: true19 }20 }21 })22});Supported content
Honest limitations
- Instagram automation depends on account type, permissions, and Meta platform rules.
- Some Instagram fields apply only to specific content types, such as Reels or carousel items.
- Media should be uploaded before post creation so the API can reference upload IDs.
Guarantees
Developer-first infrastructure
2% error rate
We handle the platform edge cases, media processing, and rate limits so your requests succeed.
Verbose errors
When native APIs fail, we return human-readable error messages and actionable recovery steps.
Flat pricing
No per-post counting. Predictable pricing for teams managing many users, workspaces, and connected accounts.
Same-day support
Direct access to the engineers building the API. We respond to technical issues the same day. Sometimes the same hour. Test us c;
FAQ
Questions developers ask before building
Can I post Instagram Reels through the API?
Yes. Use INSTAGRAM data with type REEL, text, upload IDs, and Reel-specific options such as shareToFeed where applicable.
Can I schedule Instagram Stories?
The Instagram schema supports STORY as a content type. Final behavior still depends on Meta permissions and account eligibility.
Does Instagram require a business account?
Instagram API access is governed by Meta account and permission rules. Treat personal-account automation as limited unless Meta explicitly allows it.
Can I use carousels?
Yes. Instagram carousel items can reference upload IDs and per-item metadata such as alt text and tags.
Can I get Instagram analytics?
Analytics are supported for Instagram accounts where permissions and platform availability allow collection.
Instagram API errors
Troubleshoot Instagram publishing failures, permissions, media validation, rate limits, and retry decisions.
Social Media API
See how Instagram fits into the full publishing API.
Analytics API
Connect Instagram performance data to reporting workflows.
LinkedIn API
Pair visual campaigns with B2B distribution.