Instagram Messaging API · error code

Instagram error 9007: Media is not ready for publishing (2207027)

RetryableHTTP 400Content publishing (posts, reels, stories)

Last verified against Meta for Developers - Messenger Platform error codes

What Instagram returns
The media is not ready for publishing, please wait for a moment

What 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

  1. 1Request GET /<IG_CONTAINER_ID>?fields=status_code before every publish attempt.
  2. 2Publish only when status_code is FINISHED; keep polling while it is IN_PROGRESS.
  3. 3Poll at the cadence Meta recommends - once per minute, for no more than 5 minutes - instead of hammering the endpoint.
  4. 4If the status turns ERROR, read the status field for the processing subcode and rebuild the container rather than waiting.
  5. 5For carousels, confirm every child container is FINISHED before 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

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.