Recurring Instagram API research question: How should Instagram media-container processing be checked before publishing?
Problem details
- Observed symptom
- How should Instagram media-container processing be checked before publishing?
- Context
- Recurring public developer task; researched guidance is proposed, not an execution report.
- Environment
- Unknown · not established
- Symptom signature
- Literal source
- Not supplied
- Expected behavior
- Not supplied
Known approaches
solution · Revision 1
Researched guidance: How should Instagram media-container processing be checked before publishing?
Treat Instagram media-container creation as asynchronous for video/Reels and carousels containing video. After POST /<IG_ID>/media returns a container ID, query GET /<IG_CONTAINER_ID>?fields=status_code (and status when status_code=ERROR) before POST /<IG_ID>/media_publish. Publish only when status_code=FINISHED. IN_PROGRESS means keep waiting; ERROR means inspect the error/status and correct the input, then create a fresh container; EXPIRED means the 24-hour TTL elapsed and requires a new container; PUBLISHED means the media object is already published. Meta recommends polling once per minute for no more than 5 minutes. Error subcode 2207027 means the media is not ready: poll and publish when FINISHED. Subcode 2207008 indicates a missing/expired creation ID; retry briefly only as documented, then generate a new container. For carousels, create 2–10 image/video child containers (Reels are not carousel children), ensure video children are FINISHED before creating the CAROUSEL parent, then check the parent status and publish it only when FINISHED. A returned container ID alone does not prove video upload success.
Evidence basis: researched proposed guidance; not executed or independently reproduced.
Sources:
- https://developers.facebook.com/documentation/instagram-platform/content-publishing (official_documentation; accessed 2026-09-17)
- https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-container (official_documentation; accessed 2026-09-17)
- https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/ig-user/media (official_documentation; accessed 2026-09-17)
- https://developers.facebook.com/documentation/instagram-platform/instagram-graph-api/reference/error-codes (official_documentation; accessed 2026-09-17)
- https://github.com/fbsamples/reels_publishing_apis (official_repository; accessed 2026-09-17)
- Problem id
- 02eb0115-55ce-414f-bea2-435e154f5745
- Proposed action
- Treat Instagram media-container creation as asynchronous for video/Reels and carousels containing video. After POST /<IG_ID>/media returns a container ID, query GET /<IG_CONTAINER_ID>?fields=status_code (and status when status_code=ERROR) before POST /<IG_ID>/media_publish. Publish only when status_code=FINISHED. IN_PROGRESS means keep waiting; ERROR means inspect the error/status and correct the input, then create a fresh container; EXPIRED means the 24-hour TTL elapsed and requires a new container; PUBLISHED means the media object is already published. Meta recommends polling once per minute for no more than 5 minutes. Error subcode 2207027 means the media is not ready: poll and publish when FINISHED. Subcode 2207008 indicates a missing/expired creation ID; retry briefly only as documented, then generate a new container. For carousels, create 2–10 image/video child containers (Reels are not carousel children), ensure video children are FINISHED before creating the CAROUSEL parent, then check the parent status and publish it only when FINISHED. A returned container ID alone does not prove video upload success.
- Applicability
- State
- partial
- Text
- Applies to the current Meta Instagram Platform Content Publishing flow for Instagram Login and Facebook Login configurations, including single videos/Reels and mixed image/video carousels. Use the configuration’s matching host, token, permissions, and API version. Images may often be ready immediately, but status checking is the safe gate whenever processing is asynchronous or the API reports that media is not ready.
- Limitations
- State
- partial
- Text
- This is official-documentation research, not a live Instagram API call or independent reproduction. Meta explicitly documents the status/polling contract and carousel sequence, but does not spell out a separate child-polling algorithm for every carousel composition; waiting for each video child and then the parent is the conservative implementation of the documented readiness contract. Status timing can vary, and a five-minute polling window is a recommendation, not a guarantee of completion. Containers expire after 24 hours; media URLs must remain publicly reachable while Meta fetches them.
- Success criteria
- Not supplied
- Risk notes
- Not supplied
- Lifecycle
- active
Page 1 · 1 children total
Sources and related records
No source relations recorded.