Posting to Instagram through Octopost: feed posts, carousels, stories and reels for business and creator accounts. Every post needs an image or video.
Instagram supports feed images, carousels, Reels, and Stories, but no text-only posts. Every post must include at least one image or video. Octopost handles Meta's container creation, media processing, carousel assembly, and Reel cover images automatically: you just send us your content with the media attached.
Content Limits#
| Constraint | Limit |
|---|---|
| Caption | 2,200 characters |
| Hashtags | 5 per post |
| Carousel items | 2 to 20 images or videos |
| Reel duration | 3 seconds to 15 minutes |
| Reel aspect ratio | 9:16 (1080x1920 recommended) |
| Story expiry | 24 hours |
| Image formats | JPEG (PNGs are converted to JPEG for you; WebP and GIF are refused) |
| Video formats | MP4, MOV |
| Media URLs | Must be publicly accessible |
Good to Know#
- No text-only posts. This is Instagram's biggest constraint. If you send a post to Instagram without any media, Octopost will return an error immediately:
"Instagram requires at least one image or video. Text-only posts are not supported." - 5 hashtags is the ceiling. Instagram cut the limit from 30 to 5 in December 2025. Octopost refuses a caption with more before sending anything.
- Captions don't support clickable links. URLs in captions appear as plain text. Instagram does not make them tappable. This is a platform limitation, not an Octopost one.
- Carousel items should share an aspect ratio. Mixed aspect ratios will be cropped by Instagram. For best results, keep all items consistent (1:1, 4:5, or 1.91:1).
- Media must be at a public URL. Instagram fetches images and videos from the URLs you provide. They must be accessible from Meta's servers: no auth-gated or localhost URLs.
- Stories disappear after 24 hours. This is by design. Stories are not permanent feed content.
- Instagram Business or Creator account required. Users connect their Instagram through Octopost's account settings. Personal accounts cannot use the Instagram API.
- Pick the post type on the Instagram version.
variants.instagram.instagram_post_typeisfeed(the default: several images become a carousel, one video becomes a Reel),carousel,storyorreel. - Alt text reaches feed and carousel images. Send media as
{url, alt}. Stories and Reels have no alt text on Instagram.
Platform-Specific Features#
One post, an Instagram version#
Send the post once for every network and give Instagram its own caption, media and post type in variants.instagram. The other networks get the main post.
{
"content": "cd - jumps back to the last directory you were in.",
"platforms": ["twitter", "threads", "instagram"],
"variants": {
"instagram": {
"content": "Terminal tip: cd - takes you back. #terminal #macos",
"media_urls": [
{ "url": "https://example.com/slide-1.jpg", "alt": "cd - typed in a terminal" },
{ "url": "https://example.com/slide-2.jpg", "alt": "The previous directory printed" }
],
"instagram_post_type": "carousel"
}
}
}Feed Images#
Single image or multi-image posts to the main feed. Recommended aspect ratios: 1:1 (square), 4:5 (portrait), 1.91:1 (landscape).
{
"content": "Beautiful sunset today",
"platforms": ["instagram"],
"media_urls": [{ "url": "https://example.com/sunset.jpg", "alt": "Orange sky over a lake" }]
}Carousels#
2 to 20 images or videos in a swipeable carousel:
{
"content": "Trip highlights",
"platforms": ["instagram"],
"media_urls": [
"https://example.com/day1.jpg",
"https://example.com/day2.jpg",
"https://example.com/day3.jpg"
]
}Octopost creates each child container, assembles the parent carousel container, and publishes it all from this single request.
Reels#
Vertical video posts. Use 9:16 aspect ratio at 1080x1920 for best results:
{
"content": "Quick tutorial",
"platforms": ["instagram"],
"media_urls": ["https://example.com/tutorial.mp4"],
"variants": { "instagram": { "instagram_post_type": "reel" } }
}Octopost handles Reel-specific container creation and cover image processing.
Stories#
Ephemeral content that expires after 24 hours. Each image or video becomes its own story, posted in order. Stories have no caption and take no comments, so the main post's segments don't go to an Instagram story.
{
"content": "Shown on the other networks",
"platforms": ["instagram"],
"media_urls": ["https://example.com/story-1.jpg", "https://example.com/story-2.jpg"],
"variants": { "instagram": { "instagram_post_type": "story" } }
}Threaded Posts#
Attach segments to an Instagram post: the main post publishes as a feed/carousel/reel, then each reply segment posts as a comment on it. Requires a Business or Creator account (the same constraint as posting at all). See Threaded Posts.
Comments#
Once a post is live on Instagram, open Posts, find it and click Instagram comments. You see every comment and reply on that post, and you can:
- Add a comment as your account.
- Edit one of your own comments. Instagram doesn't let apps change a comment's text, so Octopost posts the new text and removes the old comment. If the old one can't be removed, both stay and Octopost tells you.
- Reply to someone's comment.
- Hide or unhide someone's comment (a hidden comment is only visible to the person who wrote it).
- Delete any comment on your post.
Changes show up on Instagram right away. The comment Octopost posted as your first comment is marked, so you can find it. Comments can be up to 2,200 characters. The same actions are in the Posts API.
Rate Limits#
Instagram's rate limits are tied to Meta's Graph API quotas. Octopost tracks your usage and paces requests to stay within safe limits.
Things Octopost Handles for You#
You don't need to worry about any of this, but in case you're curious:
- Instagram login. Users sign in with Instagram itself (the
instagram_business_basicandinstagram_business_content_publishpermissions;instagram_business_manage_comments, used for the first comment, is still in Meta's review, so for now a first comment on Instagram is skipped and the post itself still goes out), so no Facebook Page is needed. Octopost keeps the 60-day token refreshed. - Two-step container publishing. Like Threads, Instagram requires creating a media container first, then publishing it in a separate API call. Octopost handles both steps seamlessly.
- Processing status polling. After creating a container, Instagram may need time to process the media before it can be published. Octopost polls the container status and only publishes once processing is complete, so you never hit a "media not ready" error.
- Carousel item assembly. Each carousel item must be created as its own child container, then a parent container is created referencing all children. Octopost builds this entire chain from the flat list of URLs you provide.
- JPEG conversion. Instagram only takes JPEG. Octopost checks each image and turns PNGs into JPEGs (up to 1440 px wide, under 8 MB) before Instagram fetches them. The other networks keep your original file.
- Reel cover images. Reels can have a custom cover image. Octopost handles the cover image container and attachment if you provide one.
- Content validation. Octopost validates the 2,200-character caption limit, the 5-hashtag limit, the 20-item carousel limit, and the media requirement before sending anything to Meta, giving you immediate feedback instead of opaque API errors.
- Error reporting. If something fails (media URL not accessible, account not properly connected, missing media for a required-media platform), Octopost reports exactly what went wrong.
Example#
{
"content": "New product launch! Check out the full collection.",
"platforms": ["instagram"],
"media_urls": ["https://example.com/product.jpg"]
}That's it. Octopost takes care of the rest.