Instagram: carousel, Reels, and Stories support #151

Open
opened 2026-06-23 13:32:00 +00:00 by jmiller · 0 comments
Owner

Summary

The Instagram plugin currently only supports single image posts via the 2-step container flow. The Meta Content Publishing API supports much more.

API Capabilities

Content Type API Endpoint Status
Single image /{ig_user_id}/media Done
Carousel (up to 10) /{ig_user_id}/media with media_type=CAROUSEL TODO
Reels (5-90s video) /{ig_user_id}/media with media_type=REELS TODO
Stories /{ig_user_id}/media with media_type=STORIES TODO

Carousel Flow

  1. Create each child container: POST /{ig_user_id}/media with is_carousel_item=true
  2. Create carousel container: POST /{ig_user_id}/media with media_type=CAROUSEL and children=[id1,id2,...]
  3. Publish: POST /{ig_user_id}/media_publish with creation_id

All items cropped to first image's aspect ratio. Max 10 items.

Reels

  • 9:16 aspect ratio, 5-90 seconds
  • video_url parameter (must be publicly accessible)
  • media_type=REELS

Stories

  • Expire after 24 hours
  • Image or video
  • media_type=STORIES

Acceptance Criteria

  • Carousel support when multiple media URLs provided
  • Reels support when video media with reels flag
  • Stories support when stories flag set
  • Alt text support for images (alt_text parameter)
  • Graceful fallback to single image when only one media URL

References

## Summary The Instagram plugin currently only supports single image posts via the 2-step container flow. The Meta Content Publishing API supports much more. ## API Capabilities | Content Type | API Endpoint | Status | |---|---|---| | Single image | `/{ig_user_id}/media` | **Done** | | Carousel (up to 10) | `/{ig_user_id}/media` with `media_type=CAROUSEL` | **TODO** | | Reels (5-90s video) | `/{ig_user_id}/media` with `media_type=REELS` | **TODO** | | Stories | `/{ig_user_id}/media` with `media_type=STORIES` | **TODO** | ## Carousel Flow 1. Create each child container: `POST /{ig_user_id}/media` with `is_carousel_item=true` 2. Create carousel container: `POST /{ig_user_id}/media` with `media_type=CAROUSEL` and `children=[id1,id2,...]` 3. Publish: `POST /{ig_user_id}/media_publish` with `creation_id` All items cropped to first image's aspect ratio. Max 10 items. ## Reels - 9:16 aspect ratio, 5-90 seconds - `video_url` parameter (must be publicly accessible) - `media_type=REELS` ## Stories - Expire after 24 hours - Image or video - `media_type=STORIES` ## Acceptance Criteria - [ ] Carousel support when multiple media URLs provided - [ ] Reels support when video media with `reels` flag - [ ] Stories support when `stories` flag set - [ ] Alt text support for images (`alt_text` parameter) - [ ] Graceful fallback to single image when only one media URL ## References - [Instagram Content Publishing API](https://developers.facebook.com/docs/instagram-platform/content-publishing/) - Competitive analysis: Blog2Social, Buffer, all SaaS tools support carousels
Sign in to join this conversation.
No labels
Priority Medium
Type Feature
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MokoConsulting/MokoSuiteCross#151