Instagram Messaging API · error code

Instagram error 100: Invalid message data

ConfigurationHTTP 400Generic & request errors

Last verified against Meta for Developers - Messenger Platform error codes

What Instagram returns
Invalid message data

What error 100 means

Subcode 2534015 means the message body itself is malformed for its message type. Meta's documented note: "Make sure that the type of data you are sending in your message is allowed for your message type." The recipient resolved and your credentials are fine - the payload's message object is what the platform rejected.

Instagram supports a narrower message surface than Messenger, and this error is where that narrowness shows up. Payload shapes that are legal on Messenger (certain templates, attachment types, or fields) are invalid on Instagram; a generic template with more than the documented caps, a text message over the 1,000-character limit, or an attachment type Instagram does not accept can all be reported through this subcode or its neighbors. Cross-platform senders that reuse one payload builder for Messenger and Instagram produce this error constantly.

Why it happens

  • A Messenger-only template or field was sent to an Instagram conversation from shared cross-platform code.
  • Text exceeded Instagram's documented 1,000-character / 1,000-byte UTF-8 message limit.
  • Structured message caps were exceeded - more than 10 generic-template elements, more than 3 buttons per element, more than 13 quick replies.
  • The message object mixes incompatible members, for example text plus an attachment in a single message where the type does not allow it.
  • An unsupported attachment or sticker type was specified for this route.

How to fix Instagram error 100

  1. 1Log the exact message object that failed and validate it against the Instagram send-message reference, not the Messenger one.
  2. 2Enforce Instagram's caps in your builder: 1,000 characters of text, 13 quick replies, 10 elements and 3 buttons in generic templates, 4 ice breakers.
  3. 3Split oversized content: long text into multiple messages, large carousels into smaller ones.
  4. 4Give Instagram its own payload builder or a platform-aware validation layer in cross-platform code.
  5. 5Reproduce in the Graph API Explorer to get the most specific validator message available.

How to stop it recurring

Validate outbound payloads against per-platform schemas before sending, with Instagram's documented caps encoded as constants in one module. Add contract tests that run each message type your bot produces against those schemas on every deploy. All the content ceilings live in the limits reference, and the sibling parameter errors are under code 100.

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?

Subcode 2534015 means the message body itself is malformed for its message type. Meta's documented note: "Make sure that the type of data you are sending in your message is allowed for your message type." The recipient resolved and your credentials are fine - the payload's message object is what the platform rejected.

How do I fix Instagram error 100?

1. Log the exact message object that failed and validate it against the Instagram send-message reference, not the Messenger one. 2. Enforce Instagram's caps in your builder: 1,000 characters of text, 13 quick replies, 10 elements and 3 buttons in generic templates, 4 ice breakers. 3. Split oversized content: long text into multiple messages, large carousels into smaller ones. 4. Give Instagram its own payload builder or a platform-aware validation layer in cross-platform…

Stop debugging Instagram by hand

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