Error Codes

Sample Response

{
    "error": {
        "message": "The image size is too large.",
        "type": "OAuthException",
        "code": 36000,
        "error_subcode": 2207004,
        "is_transient": false,
        "error_user_title": "Image size too large",
        "error_user_msg": "The image is too large to download. It should be less than 8 MiB.",
        "fbtrace_id": "A6LJylpZRKw2xKLFsAP-cJh"
    }
}

Error Codes

HTTP Status CodeCodeSubcodeUser MessageRecommended Solution

400

-2

2207003

It takes too long to download the media.

A timeout occured while downloading the media. Try again.

400

-2

2207020

The media you are trying to access has expired. Please try to upload again.

Generate a new container ID and use it to try again.

400

-1

2207032

Create media fail, please try to re-create media

Failed to create media container. Try again.

400

-1

2207053

unknown upload error

An unknown error occured during upload. Generate a new container and use it to try again. This should only affect video uploads.

400

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 activity to protect our community. Let us know if you can determine that the publishing actions is not spam.

400

9

2207042

You reached maximum number of posts that is allowed to be published by Content Publishing API.

The app user has reached their daily publishing limit. Advise the apps user to try again the following day.

400

24

2207006

The media with {media-id} cannot be found

Possible permission error due to missing permission or expired token. Generate a new container and use it to try again.

400

24

2207008

The media builder with creation id = {creation-id} does not exist or has been expired.

Temporary error publishing a container. Try again 1-2 times in the next 30 seconds to 2 minutes. If unsuccessful, generate a new container ID and use it to try again.

400

25

2207050

The Instagram account is restricted.

The app user's Instagram Professional account is inactive, checkpointed, or restricted. Advise the app user to sign into the Instagram app and complete any actions the app requires to reenable their account.

400

100

2207040

Cannot use more than {max-tag-count} tags per created media.

Exceeded maximum number (20) of @ tags. Advise user to use fewer @ tags.

400

352

2207026

The video format is not supported. Please check spec for supported {video} format

Unsupported video format. Advise the app user to upload a MOV or MP4 (MPEG-4 Part 14). See Video Requirements section for video requirements.

400

9004

2207052

The media could not be fetched from this uri: {uri}

The media could not be fetched from the supplied URI. Advise the app user to make sure the uri is valid and publicly available.

400

9007

2207027

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

Check the container status and publish when its status is FINISHED.

400

36000

2207004

The image is too large to download. It should be less than {size}.

Image exceeded maximum file size of 8MiB. Advise the user to try again with a smaller image.

400

36001

2207005

The image format {current-image-format} is not supported. Supported formats are: {format}.

Possible permission error due to missing permission or expired token. Generate a new container and use it to try again.

400

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 our acceptable range. Advise the app user to try again with an image that falls withing a 4:5 to 1.91:1 range.

400

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.

Exceeded the maximum amount of characters for a caption. Advise user to use a shorter caption. Maximum 2200 characters, 30 hashtags, and 20 @ tags.