2207052 (code 9004)
Instagram could not fetch the media while building its publishing container.
Fix: Retry once. If Instagram still cannot fetch it, re-upload the file to PublishQ and publish the new media item.
Instagram image failures are usually caused by aspect ratio, not a large square resolution. Feed and carousel images must stay between 9:16 and 16:9, with 4:5 recommended for portrait feed posts; Instagram can downscale wider supported images during processing.
Updated July 2026
Recommended sizes
Use these sizes when you need a sensible default. The tables below cover the limits enforced by the API.
Square feed image
1080×1080 (1:1)
A good square image size for feed posts and carousels.
Portrait feed image
1080×1350 (4:5)
The widely used recommended portrait format for feed posts.
Reels and Stories
1080×1920 (9:16)
The recommended vertical full-screen format.
API limits
Check these values in your upload validator or before an agent submits a post.
Image constraints for feed, carousel, and Story publishing.
Limits for Reels, feed videos, Stories, and captions.
Account-level constraints specific to API publishing.
Common publishing errors
Find the returned code or the closest matching failure below, then fix the cause before retrying the post.
Instagram could not fetch the media while building its publishing container.
Fix: Retry once. If Instagram still cannot fetch it, re-upload the file to PublishQ and publish the new media item.
The submitted image aspect ratio is outside Instagram’s accepted range.
Fix: Crop or pad the image to a ratio between 9:16 and 16:9.
The media container is still processing and is not ready to publish.
Fix: Poll the container until it reports FINISHED before calling media_publish.
The account has reached the Content Publishing API daily limit.
Fix: Check content_publishing_limit and wait for the rolling 24-hour quota to clear.
The Instagram access token has expired, was revoked, or no longer grants publishing access.
Fix: Reconnect the Instagram Business or Creator account before retrying the post.
Instagram blocked the publishing action after detecting unusual or repetitive activity.
Fix: Pause retries, check the account for restrictions, and wait before sending a revised post.
Instagram found the same caption or media in a recently published post.
Fix: Change the caption or media before trying again instead of resubmitting the same payload.
Send PublishQ the post. We check it, prepare the media, and deliver it to Instagram. You can work in the dashboard or connect through the API, CLI, or MCP server.
Common questions about Instagram media sizes and API publishing limits.
Use 1080×1080 for square posts, 1080×1350 for portrait feed posts, and 1080×1920 for Stories or Reels. Feed images must remain between 9:16 and 16:9.
Not necessarily. Instagram can downscale larger images. Unsupported aspect ratios are a more common API failure than large square resolution.
Send Instagram posts through the PublishQ API or MCP server. PublishQ delivers the media with the selected content type and platform settings.
API reference for Instagram API.
See exactly how your posts will look on Twitter, Instagram, LinkedIn, TikTok, and more before you publish. No signup required.
Turn an idea into a ready-to-post short video. Pick a template, let AI handle the rest, and schedule it — all without leaving PublishQ.
Preview how your post looks on each platform, customize the text per account if needed, then publish or schedule to all of them at once.
Upload images and videos once, then reuse them across any post. No more digging through your camera roll or re-uploading the same file to every platform.
Schedule Reels, carousels, Stories, and image posts to Instagram. Control share-to-feed, trial reels, and audio name. Preview how they look before going live.