Instagram Messaging API · error code

Instagram error 100: No matching Instagram user

ConfigurationHTTP 400Recipient & delivery

Last verified against Meta for Developers - Messenger Platform error codes

What Instagram returns
No matching Instagram user

What error 100 means

Subcode 2534014 means the recipient ID you sent does not resolve to an Instagram user in this messaging context. Meta's documented note names the usual culprit: "Check to make sure the ID you are using is a valid Instagram-scoped ID. Instagram User ID are not supported." Instagram messaging addresses people by IGSID - the Instagram-scoped ID that arrives in your webhook events - and that is a different namespace from the Instagram user IDs returned by the content and insights APIs, from usernames, and from Facebook PSIDs.

IGSIDs are also scoped: the same human has a different IGSID for each account-and-app pairing. IDs exported from another tool, harvested under a previous app, or copied across connected accounts will all land here. The practical rule is absolute - if the ID did not come from a webhook event (or a Conversations API read) for this account under this app, you cannot message it.

Why it happens

  • An Instagram user ID from the Graph content APIs, or a username, was used as recipient.id.
  • An IGSID obtained under a different app or a different connected account was reused.
  • The ID was truncated, reformatted, or run through a numeric type that lost precision (large IDs mangled by 32-bit ints or floating point).
  • A Facebook PSID from a Messenger integration was sent to the Instagram endpoint.

How to fix Instagram error 100

  1. 1Trace the failing ID to its origin; only IGSIDs from this pairing's webhook events or conversation reads are valid.
  2. 2Store IGSIDs as strings end to end - never parse them as numbers in JavaScript or spreadsheets.
  3. 3For migrations between apps, plan for re-identification: IGSIDs do not transfer, so match people by conversation content or wait for fresh inbound events.
  4. 4Log the recipient ID with every send so a bad-ID regression is visible in one place.

How to stop it recurring

Type the IGSID in your codebase as an opaque string bound to (account, app), and reject sends whose recipient did not originate from the matching webhook stream. Migrations and multi-app setups are where this bites hardest - budget for the re-identification step. The ID plumbing is explained in the Instagram troubleshooting guide, and the generic parameter failure it specializes is 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 2534014 means the recipient ID you sent does not resolve to an Instagram user in this messaging context. Meta's documented note names the usual culprit: "Check to make sure the ID you are using is a valid Instagram-scoped ID.

How do I fix Instagram error 100?

1. Trace the failing ID to its origin; only IGSIDs from this pairing's webhook events or conversation reads are valid. 2. Store IGSIDs as strings end to end - never parse them as numbers in JavaScript or spreadsheets. 3. For migrations between apps, plan for re-identification: IGSIDs do not transfer, so match people by conversation content or wait for fresh inbound events. 4. Log the recipient ID with every send so a bad-ID regression is visible in one place.

Stop debugging Instagram by hand

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