Instagram error 2207027: media not ready to publish
Instagram error 2207027, returned with code 9007, means the media container is not ready to publish yet, usually because Instagram is still processing a video. Nothing in the request needs fixing. Check the container's status_code and call media_publish again once it reads FINISHED, which Meta suggests checking once a minute for up to 5 minutes.
easyCoexistence's publish_instagram_post checks the container's status before it publishes, so Claude, ChatGPT or your own code do not have to.
The error code returned with subcode 2207027, when the media is not ready for publishing.
The status_code at which a container and its media object are ready to be published.
How often Meta recommends querying a container's status, for no more than 5 minutes.
How long a container can stay unpublished before its status_code turns to EXPIRED.
What does error 2207027 mean?
The container exists, but its media is not ready to be published. Meta's user message reads: The media is not ready for publishing, please wait for a moment. It comes from POST /<IG_ID>/media_publish, the second of the two publishing calls, when that call is made before Instagram has finished preparing the media, which mostly happens with video.
Meta's fix is to check the container's status and publish when it reads FINISHED. The request was right; only the timing was early.
Which status codes can a container have?
GET /<IG_CONTAINER_ID>?fields=status_code returns one of five values, and each calls for something different:
IN_PROGRESS: Instagram is still processing the media. Wait and check again.- FINISHED: the container and its media are ready. Call
media_publishnow. - ERROR: processing failed. The container's status field holds the error subcode; fix the media and create a new container.
- EXPIRED: the container was not published within 24 hours. Create a new one.
- PUBLISHED: the media is already live, so there is nothing left to publish.
How long should you wait?
Meta recommends querying a container's status once per minute, for no more than 5 minutes, and publishing as soon as it reads FINISHED. A container that still reads IN_PROGRESS when that time is up is worth checking against the video specification before you create a new one, since a file Instagram cannot process ends in ERROR rather than FINISHED.
# 1. Read the container's status
curl "https://graph.instagram.com/<IG_CONTAINER_ID>?fields=status_code,status&access_token=<ACCESS_TOKEN>"
# 2. Once status_code reads FINISHED, publish it
curl -X POST "https://graph.instagram.com/<IG_ID>/media_publish?creation_id=<IG_CONTAINER_ID>&access_token=<ACCESS_TOKEN>"Is it worth retrying?
Yes, and it is one of the few publishing errors where the same call works later: once the container reads FINISHED, media_publish with the same creation_id goes through. Retry on the status rather than on a timer alone. A loop that calls media_publish every few seconds gets the same error each time and spends API calls the account could use elsewhere.
Common mistakes
- Publishing straight after creating a video container. The container ID comes back before processing is done, so check status_code first.
- Creating a new container after this error. The first one is still processing, and a duplicate only starts the wait again.
- Ignoring ERROR. A container in that state never reaches FINISHED; read its status field and fix the media.
- Leaving a finished container for later. It expires 24 hours after it was created, and publishing then needs a new one.
While a video is still processing, it says so, and easyCoexistence finishes the post on its own. US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.
easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.
Frequently asked questions
Is error 9007 the same as 2207027?
Yes. 9007 is the code and 2207027 the subcode of the same error, and both mean the container is not ready to publish yet.
How long does Instagram take to process a video?
Meta publishes no fixed time. Its guidance is to check the container's status once a minute for up to 5 minutes and publish when status_code reads FINISHED.
What if the status reads ERROR?
Processing failed and the container will not publish. Its status field holds the error subcode, which names what to fix in the media before you create a new container.
Does waiting use up the daily publishing limit?
No. The limit counts containers that have been published. Creating extra containers while waiting counts toward a different ceiling: 400 per account in a rolling 24 hours.
Keep reading
Connect your first channel in two minutes.
No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.
- 3 days free
- Cancel any time
- Official APIs only
- Monitored 24/7
Verified on