The error codes and messages listed in this article might not be up-to-date. For the most updated list of error codes, visit the Meta’s documentation here.
Here is a list of Instagram error codes, their possible causes, and suggested solutions:
| Error code | Error sub-code | Description | Possible cause and suggested solution |
| -2 | 2207003 | It takes too long to download the media. | A timeout occured while downloading the media file. Please try again later. |
| -2 | 2207020 | The media you are trying to access has expired. Please try to upload again. | The media file you are trying to access has expired. Generate a new container ID and try again. |
| -1 | 2207001 | An error occurred in the Instagram server. Please try again later. | |
| -1 | 2207032 | Create media fail, please try to re-create media | Unable to create a media container. Please try again later. |
| -1 | 2207053 | unknown upload error | An unknown error occured when uploading video. Generate a new container and try uploading again. |
| 1 | 2207057 | Thumbnail offset must be greater than or equal to 0 and less than video duration, i.e. {video-length} | The thumbnail offset you entered is out of bounds for the video duration. Thumbnail offset must be greater than or equal to 0 and less than video duration. Add the right offset and try again. |
| 4 | 2207051 | We restrict certain activity to protect our community. Tell us if you think we made a mistake. | The publishing action is suspected to be spam. We restrict certain activities to protect our community. Contact Instagram support to follow up if the publish action is not spam. |
| 9 | 2207042 | You reached maximum number of posts that is allowed to be published by Content Publishing API. |
You have reached the daily maximum number of posts allowed to be published by the Content Publishing API. Please try posting again tomorrow.
|
| 24 | 2207006 | The media with {media-id} cannot be found | Unable to find the media file with the associated media ID. This may occur when there is a missing permission or the token has expired. Generate a new container and try again. |
| 24 | 2207008 | The media builder with creation id = {creation-id} does not exist or has been expired. | A temporary error occurred when publishing a container. The media builder with the associated creation ID does not exist or it has expired. Try again later, or generate a new container ID and try again. |
| 25 | 2207050 | The Instagram account is restricted. | The Instagram account is restricted. The Instagram Professional account may be inactive or checkpointed. Sign in to the Instagram app and complete any actions to re-enable your account. |
| 100 | 2207023 | The media type {media-type} is unknown. | Unknown media type. Please enter the correct one and try again. |
| 100 | 2207028 | Your post won't work as a carousel. Carousels need at least 2 photos/videos and no more than 10 photos/videos. | Unable to publish post as a carousel. A carousel post requires a minimum of 2 and a maximum of 10 photos or videos. Please try again using an acceptable number of media items for a carousel post. |
| 100 | 2207035 | Product tag positions should not be specified for video media. | Product tag positions cannot be specified for video media. Videos do not support X/Y coordinates for tagging. Please remove any X/Y coordinate settings when using videos, and try again. |
| 100 | 2207036 | Product tag positions are required for photo media. | Product tag positions are required for photo media. Image product tags must include valid X/Y coordinate settings. Please ensure you provide the necessary X/Y coordinates for your product tags when using photo media, and try again. |
| 100 | 2207037 | We couldn't add all of your product tags. The product ID may be incorrect, the product may be deleted, or you may not have permission to tag the product. | Unable to add all of the requested product tags. This may be because the product ID is incorrect, the product has been deleted, or you do not have permission to tag that product. Please review the valid products in your catalog and only use the eligible product IDs when tagging this post. Then try adding the product tags again. |
| 100 | 2207040 | Cannot use more than {max-tag-count} tags per created media. | You have exceeded the limit of 20 @mention tags when creating media. Use fewer @mention tags and try again. |
| 352 | 2207026 | The video format is not supported. Please check spec for supported {video} format | The video format you uploaded is not supported. Please upload a video in .MOV or .MP4 (MPEG-4 Part 14) format and try again. |
| 9004 | 2207052 | The media could not be fetched from this uri: {uri} | Unable to fetch media from the URL. Please make sure the URL is valid and publicly available. |
| 9007 | 2207027 | The media is not ready for publishing, please wait for a moment | The media is not ready for publishing. Please check the container status and publish once the status is "Finished". |
| 36000 | 2207004 | The image is too large to download. It should be less than {size}. | The image you tried to upload exceeds the maximum file size of 8 MB. Please try uploading the image again with a smaller file size. |
| 36001 | 2207005 | The image format {current-image-format} is not supported. Supported formats are: {format}. | The image format is not supported |
| 36003 | 2207009 | The submitted image with aspect ratio {submitted-ratio} cannot be published. Please submit an image with a valid aspect ratio. | The image's aspect ratio does not fall within the allowed range. Please try again using an image that falls within a 4:5 to 1.91:1 aspect ratio range． |
| 36004 | 2207010 | The submitted image's caption was {submitted-caption-length} characters long. The maximum number of characters permitted for a caption is {maximum-caption-length}. Please submit media with a shorter caption. | The caption you submitted exceeded the character limit of 2,200 characters. Please note that the maximum amount of characters for a caption is 2,200 characters, 30 hashtags, and 20 @mention tags. |