Instagram error 9007: Media is not ready for publishing (2207027)
Last verified against Meta for Developers - Messenger Platform error codes
The media is not ready for publishing, please wait for a momentWhat error 9007 means
Code 9007 with subcode 2207027 comes from POST /<IG_ID>/media_publish. Your app handed Instagram a creation_id for a container whose media is still being processed, and the publish call refuses to go ahead until that processing finishes. Meta's recommended solution is short and exact: check the container status and publish when its status is FINISHED.
Nothing is broken with your token, your permissions or the media itself. Video, reel and story containers are processed asynchronously - Meta's media reference states that receiving a container ID does not guarantee the upload succeeded - so a pipeline that creates a container and calls media_publish a second later will hit this on nearly every video. Images usually process fast enough to hide the race, which is why the error often appears only once a scheduler starts posting reels.
The fix is a wait, not a new container. The same container ID will publish cleanly once processing completes, provided it has not reached its 24-hour expiry.
What it looks like
{
"error": {
"type": "OAuthException",
"code": 9007,
"error_subcode": 2207027,
"error_user_msg": "The media is not ready for publishing, please wait for a moment",
"fbtrace_id": "AqT3mZp8RkWcVn1"
}
}Why it happens
- The app calls media_publish immediately after creating a video, reel or story container.
- A carousel parent was published while one of its video children was still IN_PROGRESS.
- A resumable upload to rupload.facebook.com had not finished transferring when publishing was attempted.
- Large or high-bitrate video files take longer to transcode than the app's fixed delay allows.
How to fix Instagram error 9007
- 1Request
GET /<IG_CONTAINER_ID>?fields=status_codebefore every publish attempt. - 2Publish only when
status_codeisFINISHED; keep polling while it isIN_PROGRESS. - 3Poll at the cadence Meta recommends - once per minute, for no more than 5 minutes - instead of hammering the endpoint.
- 4If the status turns
ERROR, read thestatusfield for the processing subcode and rebuild the container rather than waiting. - 5For carousels, confirm every child container is
FINISHEDbefore creating and publishing the parent.
How to stop it recurring
Model publishing as a two-phase job: create the container, then hand it to a status-polling worker that publishes only on FINISHED. Never chain the two calls in one request handler. A queue with delayed retries also keeps you clear of the 400-containers-per-24-hours cap, because retries reuse the existing container instead of creating fresh ones. Expired containers surface as 24/2207008.
Official reference: Meta for Developers - Messenger Platform error codes. See all Instagram error codes or the Instagram limits and quotas.
Related codes
- 24: Media builder does not exist or has expired (2207008)The media builder with creation id = {creation-id} does not exist or has been…
- -1: Unknown upload error (2207053)unknown upload error
- -2: Media has expired - upload again (2207020)The media you are trying to access has expired. Please try to upload again.
- -1: Create media failed (2207032)Create media fail, please try to re-create media
Error 9007 - quick answers
What does Instagram error 9007 mean?
Code 9007 with subcode 2207027 comes from POST /<IG_ID>/media_publish . Your app handed Instagram a creation_id for a container whose media is still being processed, and the publish call refuses to go ahead until that processing finishes. Meta's recommended solution is short and exact: check the container status and publish when its status is FINISHED .
How do I fix Instagram error 9007?
1. Request GET /<IG_CONTAINER_ID>?fields=status_code before every publish attempt. 2. Publish only when status_code is FINISHED ; keep polling while it is IN_PROGRESS . 3. Poll at the cadence Meta recommends - once per minute, for no more than 5 minutes - instead of hammering the endpoint. 4. If the status turns ERROR , read the status field for the processing subcode and rebuild the container rather than waiting. 5. For carousels, confirm every child container is FINISHED…
Can I retry after error 9007?
Yes - this is a retryable condition. Back off (start around one second and double on each attempt, with jitter) and watch for a retry-after hint from the platform before resending.
Stop debugging Instagram by hand
Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.