Instagram Messaging API · error code

Instagram error 100: Page is not linked to an Instagram account

ConfigurationHTTP 400Account setup & connection

Last verified against Meta for Developers - Messenger Platform error codes

What Instagram returns
The page is not linked to an Instagram account

What error 100 means

Subcode 2534013 means the Facebook Page ID in your call has no Instagram professional account linked to it. Meta's documented note is direct: "The Page ID used in your API calls must be for the Facebook Page linked to your Instagram Professional account." On the Messenger Platform route every Instagram messaging call is addressed through the Page, so an unlinked Page is a dead end regardless of tokens or permissions.

Two distinct situations produce it. Either the link genuinely does not exist - the Instagram account is personal rather than professional, or was never connected to this Page - or the link exists but you are calling the wrong Page: businesses with several Pages, or agencies managing many, routinely send with Page A's ID while the Instagram account hangs off Page B. The companion symptom during onboarding is an empty instagram_business_account field when reading the Page, which is the same condition seen from the other side.

Note that the newer Instagram API with Instagram Login removes the Page requirement entirely; if a Page link is not viable for the business, that route is the structural fix.

Why it happens

  • The Instagram account is a personal account, which cannot be linked for API messaging - it must be Business or Creator.
  • The Page and Instagram account were never linked, or the link was removed during a rebrand or account cleanup.
  • The call uses the wrong Page ID - the business has multiple Pages and the Instagram account is linked to a different one.
  • The link was made from the Instagram side only and never confirmed on the Page side.

How to fix Instagram error 100

  1. 1Call GET /me/accounts?fields=name,instagram_business_account with the user token and find which Page (if any) carries the Instagram account.
  2. 2If none does, link them: on the Page, Settings > Linked accounts > Instagram, and connect the professional account.
  3. 3Convert the Instagram account to a professional account first if it is personal (Instagram Settings > Account type and tools).
  4. 4Update your stored Page ID to the Page that actually holds the link, and retest the send.
  5. 5If the business cannot maintain a Page link, migrate to the Instagram API with Instagram Login, which does not require one.

How to stop it recurring

Assert the link during onboarding - read instagram_business_account from the chosen Page and block completion if it is missing - and re-assert it on a schedule, because anyone with Page access can unlink at any time without your app being told. Store the Page-to-Instagram pairing you validated and alert when it changes. This is step 1 of the checklist in the troubleshooting guide; the two routes' differing account requirements are compared in the limits reference.

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 2534013 means the Facebook Page ID in your call has no Instagram professional account linked to it.

How do I fix Instagram error 100?

1. Call GET /me/accounts?fields=name,instagram_business_account with the user token and find which Page (if any) carries the Instagram account. 2. If none does, link them: on the Page, Settings > Linked accounts > Instagram, and connect the professional account. 3. Convert the Instagram account to a professional account first if it is personal (Instagram Settings > Account type and tools). 4. Update your stored Page ID to the Page that actually holds the link, and retest…

Stop debugging Instagram by hand

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