Messenger Platform · error code

Messenger error 100: Incorrect App ID

ConfigurationHTTP 400Generic & request errors

Last verified against Meta for Developers - Messenger Platform error codes

What Messenger returns
Incorrect App ID.

What error 100 means

Code 100 with subcode 2018164 is terse even by Graph API standards: "Incorrect App ID." The app identity attached to your request does not match what the operation expects, the token was minted under one app while the request context references another, or an explicit app-ID parameter in the call names the wrong application.

Messenger integrations are unusually exposed to this because the Page-app relationship is load-bearing: webhook subscriptions, PSID scoping and thread control all bind to a specific app. Organizations accumulate apps, a prototype, a staging app, the production app, an agency's app from a previous vendor, and Pages end up connected to several. A token generated in the wrong dashboard tab, an environment variable pointing at the staging app ID, or a migration that moved the Page to a new app while jobs still run with the old identity will all land here.

The diagnosis is mechanical: introspect the failing token in the Access Token Debugger and read which app and Page it belongs to, then compare with the app ID your configuration believes it is using. Remember the knock-on effect explained on the 2018001 page: PSIDs are scoped to the app-Page pair, so "fixing" a mismatch by switching apps invalidates stored recipient IDs, a planned migration with ID re-matching, not a config flip.

What it looks like

{
  "error": {
    "message": "(#100) Incorrect App ID.",
    "type": "OAuthException",
    "code": 100,
    "error_subcode": 2018164,
    "fbtrace_id": "BLBz/WZt8dN"
  }
}

Why it happens

  • Access tokens generated under a different app than the one configured for the integration.
  • Environment variables mixing staging and production app IDs.
  • Multiple apps historically connected to the Page, with credentials crossed between them.
  • Migrations that moved the Page to a new app while old jobs kept the old identity.
  • Explicit app-ID parameters (e.g. in account-linking or attachment flows) naming the wrong app.

How to fix Messenger error 100

  1. 1Introspect the token in the Access Token Debugger; note its app ID and Page.
  2. 2Compare against the app ID in your config; align them, regenerate the token under the correct app if needed.
  3. 3Audit environment configs so each environment carries one coherent (app ID, secret, token) triple.
  4. 4If the Page must move apps, plan for PSID re-matching via the ID-matching API rather than an in-place swap.
  5. 5Remove stale app connections from the Page (Settings -> Business Integrations) to shrink the confusion surface.

How to stop it recurring

Treat (app ID, app secret, Page token) as one atomic credential set, stored together, rotated together, never mixed across environments. A startup assertion that introspects the token and compares its app ID against config catches every variant of this error before traffic does. App-and-Page identity pitfalls, including the PSID consequences, are covered in the Messenger troubleshooting guide.

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

Related codes

Error 100 - quick answers

What does Messenger error 100 mean?

Code 100 with subcode 2018164 is terse even by Graph API standards: "Incorrect App ID." The app identity attached to your request does not match what the operation expects, the token was minted under one app while the request context references another, or an explicit app-ID parameter in the call names the wrong application.

How do I fix Messenger error 100?

1. Introspect the token in the Access Token Debugger; note its app ID and Page. 2. Compare against the app ID in your config; align them, regenerate the token under the correct app if needed. 3. Audit environment configs so each environment carries one coherent (app ID, secret, token) triple. 4. If the Page must move apps, plan for PSID re-matching via the ID-matching API rather than an in-place swap. 5. Remove stale app connections from the Page (Settings -> Business…

Stop debugging Messenger by hand

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