Instagram API errors and troubleshooting

Reconnect Instagram through Meta and approve all required permissions again. This often happens after removing app access, changing security settings, or switching business assets.

Ask the user to log into Facebook or Instagram, clear any security checkpoint, then reconnect the account to create a fresh token.

Open Facebook or Instagram directly and complete pending email, phone, identity, or security confirmation steps before reconnecting.

Switch the account to a Business or Creator account, connect it to a Facebook Page when required, then reconnect it in bundle.social.

Reconnect the account and grant publishing permissions such as instagram_basic and instagram_content_publish. Check app review when this only fails for live users.

Open Instagram and Meta Account Quality as the user. Resolve warnings, identity checks, spam restrictions, or policy appeals before retrying.

Use a public HTTPS media URL that responds quickly, avoids login pages, returns the right content type, and stays available during container creation.

Check redirects, signed URL expiry, bot protection, file permissions, and content-type headers. Generate a new media URL and retry.

Create a fresh media container and publish it quickly. Do not reuse old creation IDs from previous attempts.

Start the upload flow again. Treat this as stale state, not as a post that should be retried with the same container ID.

Retry once with a fresh container. If it repeats, validate the media file against Instagram size, codec, duration, and aspect-ratio rules.

Retry after a short delay. If only one asset fails, re-export that asset and upload it again to rule out file corruption.

Compress or resize the image before upload. Keep the file within Instagram image limits and preserve a supported format.

Convert the image to JPG or PNG and upload a clean version. Avoid HEIC, WebP, animated image formats, and mislabeled content types.

Crop or resize the image or video into an accepted Instagram ratio. Common safe choices are square, portrait 4:5, and landscape 1.91:1.

Regenerate the asset for the selected post type. Check that feed, carousel, Reel, and Story assets use compatible dimensions.

Resize the image to a supported resolution and upload a new file. Avoid extremely small, extremely large, or incorrectly rotated images.

Export the video as MP4 with a supported video and audio codec. Replace the uploaded media instead of retrying the same file.

Use a thumbnail offset that exists inside the video duration, or remove the custom offset and let Instagram choose the thumbnail.

Send the correct media type for the endpoint and make sure the URL points directly to the final image or video file.

Shorten the caption before publishing. Keep captions under Instagram limits and avoid hidden extra characters from templates.

Change the caption, hashtags, links, or posting pattern. Ask the user to review account status if similar content keeps failing.

Wait before retrying, reduce repeated content, and check whether the account has a temporary restriction or suspicious activity prompt.

Check carousel item count, media type compatibility, consistent aspect ratios, and whether every child container finished processing.

Remove positioned product tags from video posts. Use product tags only where Instagram supports them for the selected media type.

Send x and y product tag coordinates for each tagged product. Validate coordinates before submitting the post.

Verify product IDs, catalog access, shop eligibility, and tag positions. Remove invalid tags before retrying.

Reduce the number of tagged products and retry with a smaller set that matches Instagram product-tag limits.

Wait for the limit window to reset. Spread scheduled posts over time instead of retrying all failed jobs immediately.

Delay remaining posts until the next allowed window and throttle future schedules for that account.

Retry with backoff and keep the raw Meta response for support. If it persists, check Meta platform status and retry later.