Instagram Stories API for Developers
Post ephemeral Stories to Instagram automatically. Images or videos, scheduled or immediate — set publicationType to STORY and your content appears in Stories for 24 hours.
How Instagram Stories works via PostPulse
Instagram Stories are the highest-engagement format on the platform, with over 500 million accounts using Stories daily. Automating Stories via the native Instagram API requires going through Meta's App Review — a process that often takes weeks. PostPulse gives you immediate Stories publishing access. Set publicationType to STORY in platformSettings, include the media path in attachmentPaths, and your Story goes live.
PostPulse handles OAuth token management, media validation against Instagram's requirements (formats: JPG, PNG, MP4, MOV), and the async delivery to Instagram's API. Real-time webhook events notify your application when publishing succeeds or fails.
Code Example: Instagram Stories
A complete working example showing how to use the PostPulse API for Instagram stories.
# Import media from URL
curl -X POST https://api.post-pulse.com/v1/media/upload/import \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "url": "https://your-cdn.com/your-media-file.mp4" }'
# Response: { "path": "uuid/media-file.mp4" }
# Create post with the publications array
curl -X POST https://api.post-pulse.com/v1/posts \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"scheduledTime": "2025-06-01T10:00:00Z",
"isDraft": false,
"publications": [{
"socialMediaAccountId": 123,
"platformSettings": { "type": "INSTAGRAM", "publicationType": "STORY" },
"posts": [{
"content": "Published via PostPulse API #automation",
"attachmentPaths": ["uuid/media-file.mp4"]
}]
}]
}'What you can build with Instagram Stories
Schedule daily Stories from a content calendar
Auto-post promotional Stories for limited-time offers
Share behind-the-scenes content automatically
Cross-post Stories across Instagram and Facebook simultaneously
Stories is also available on
Use the same feature across multiple platforms with a single PostPulse integration.
Why developers picked PostPulse for Instagram Stories
Reviewed on Product HuntI use PostPulse with an AI agent via their MCP server. My agent literally posts to social media on its own now. Didn’t expect that to work as smoothly as it did.
$5/month for what would otherwise require a full backend engineer to maintain? Easy yes. The REST API is clean and well-documented too, which is rare.
Tried to get TikTok API access myself. Three weeks, two rejections. Switched to PostPulse and was posting to TikTok the same day. Wish I hadn’t wasted that time.
I’m a Make.com power user and needed to post to 5 platforms from one scenario. The native PostPulse app for Make connected everything in one afternoon. Would’ve taken me weeks to do manually.
I built an n8n automation for a client and needed to add social publishing. The official PostPulse n8n node was literally drag and drop. No headache.
Saved me months of dev work. I was about to start integrating Instagram and TikTok APIs separately — then I found out Meta’s app review alone can take months. PostPulse just handled all of that. Shipped social posting in under a week.
The most flexible pricing model on the market!
I'm building an AI content factory as a side hustle. I'm still in the experimentation phase, so I don't have the budget for expensive tools — but I also needed to get everything up and running quickly, so I integrated with a ready-to-go API instead. PostPulse offers a flexible pay-as-you-go model that let me experiment first without commitment — and now that we have stable traffic, I’ve switched to their $5/month subscription.
Best support on the market — the founder personally emailed me when I hit a client error and walked me through the fix.
We optimized the posting to 20 twitter accounts. It was a problem to manage such a number, but through the platform everything works out perfectly. Very convenient dashboard for tracking errors. Great product.
Instagram Stories — FAQ
Add Instagram Stories to your app today
Get API access in minutes. No platform audit. No enterprise contract. Make your first Instagram stories call in under 10 minutes.