Instagram Messaging API · error code

Instagram error 100: Unknown media type (2207023)

Permanent - do not retryHTTP 400Content publishing (posts, reels, stories)

Last verified against Meta for Developers - Messenger Platform error codes

What Instagram returns
The media type {media-type} is unknown.

What error 100 means

Code 100 with subcode 2207023 means the media_type value on your container request is not one Instagram recognizes. Meta's recommended solution is to enter one of the expected media types. The message echoes back the value it rejected, which usually makes the bug obvious.

The accepted values depend on what you are publishing. The content publishing guide says to set media_type to VIDEO, REELS or STORIES for video containers and to CAROUSEL for a carousel parent. Single feed images take no media_type at all - an image_url alone is enough. Values like IMAGE, PHOTO, REEL, STORY or CAROUSEL_ALBUM are common mistakes. The last one is especially easy to make because CAROUSEL_ALBUM is what Instagram returns when you read a published media object, but it is not what you send when creating one.

Casing and whitespace matter too. Treat the value as an exact enum, not free text.

What it looks like

{
  "error": {
    "type": "OAuthException",
    "code": 100,
    "error_subcode": 2207023,
    "error_user_msg": "The media type CAROUSEL_ALBUM is unknown.",
    "fbtrace_id": "NpS2dLr8WjZu4Af"
  }
}

Why it happens

  • The app sent a read-side value such as CAROUSEL_ALBUM or IMAGE when creating a container.
  • The value was singular or misspelled, for example REEL or STORY.
  • The value was lowercase or had trailing whitespace from a form field.
  • A media_type was supplied for a plain feed image where none is needed.

How to fix Instagram error 100

  1. 1Read the rejected value in the error message.
  2. 2Use exactly REELS, STORIES, VIDEO or CAROUSEL as appropriate for the container.
  3. 3Omit media_type entirely for a single feed image sent with image_url.
  4. 4Map your internal post types to these constants in one place instead of passing user input through.
  5. 5Create the container again with the corrected value.

How to stop it recurring

Define the write-side media types as constants in a single mapping layer and keep them separate from the read-side values you get back from the media endpoints. Add a unit test that every post type your composer offers maps to a valid container request. Carousel structure is validated separately, as 100/2207028.

Official reference: Meta for Developers - Messenger Platform error codes. See all Instagram error codes or the Instagram limits and quotas.

Related codes

Error 100 - quick answers

What does Instagram error 100 mean?

Code 100 with subcode 2207023 means the media_type value on your container request is not one Instagram recognizes. Meta's recommended solution is to enter one of the expected media types. The message echoes back the value it rejected, which usually makes the bug obvious. The accepted values depend on what you are publishing.

How do I fix Instagram error 100?

1. Read the rejected value in the error message. 2. Use exactly REELS , STORIES , VIDEO or CAROUSEL as appropriate for the container. 3. Omit media_type entirely for a single feed image sent with image_url . 4. Map your internal post types to these constants in one place instead of passing user input through. 5. Create the container again with the corrected value.

Should I retry after error 100?

No. Retrying the same request produces the same error; the condition has to be fixed first. Treat it as a permanent failure for that message and surface it, rather than looping.

Stop debugging Instagram by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.