How to Fix the Instagram Messaging API Error
If you’re trying to connect your Instagram account to LinktoDM and see the message “Instagram Business API: Your Instagram account is ineligible for using Instagram Business Messaging API,” this guide will help you fix it.
First, which way did you connect?
Section titled “First, which way did you connect?”The eligibility rules are different on the two connection routes, and most wasted time on this error comes from working through the wrong list. LinktoDM offers:
- Instagram login — you sign in with your Instagram credentials. No Facebook involved at any point.
- Facebook login — you sign in with Facebook and connect a Page. The Page carries the permissions.
Why a Facebook Page is required explains the difference in full. Pick your route below.
If you connected with Instagram login
Section titled “If you connected with Instagram login”There is exactly one requirement, and no Facebook Page or Business Manager is involved.
Your Instagram account must be professional. Business and Creator both work — Meta exposes messaging on either. A personal account cannot be automated by LinktoDM or by any other tool, because Meta doesn’t expose the messaging permissions on it at all. See why a professional account is required.
To see which type you’re on, open Creator tools and controls under For professionals in Instagram’s settings. That entry is named after the type you’re currently on, and the panel lists the types you can move to.
Switching a personal account to professional is free, takes about a minute, and doesn’t change your handle, followers or posts.
Then check the messaging switch, which a switch of account type resets:
- Switch Allow access to messages on. It lives in the Instagram mobile app, not on the web — Fix DM access disabled has the steps and covers this one on its own.
You do not need a Facebook account, a Facebook Page, or a Meta Business portfolio on this route. If a checklist somewhere told you otherwise, it was describing the Facebook route.
If you connected with Facebook login
Section titled “If you connected with Facebook login”Here the Facebook Page is the object Meta attaches permissions to, so the Page requirements come first.
- You must administer a Facebook Page. Being able to post to a Page is not the same as being an admin of it — without the admin role there is nobody Meta will accept the permission grant from. A Page on its own is a complete setup for Messenger DMs and comment-to-DM on Facebook posts.
- For the Instagram features, link an Instagram professional account to that Page. The linkage is made from Instagram’s professional account settings, or from the Page’s own Linked accounts settings on Facebook. An Instagram account with no linked Page cannot use this route — that’s the one thing the Page is genuinely required for.
- Add both the Page and the Instagram account to the same Meta Business portfolio. Meta Business Settings → Accounts → add them under Pages and Instagram accounts. Both in the same portfolio; split across two is a common cause of this error.
- Turn message access on. The Allow access to messages switch is in the Instagram mobile app — Fix DM access disabled.
After you change anything
Section titled “After you change anything”Meta doesn’t propagate these changes instantly. Give it a while — often under an hour, sometimes several — then connect to LinktoDM again. Reconnecting repeatedly in the meantime doesn’t speed it up.
Then comment your trigger word from a second account and confirm both the public reply and the DM arrive.
Still not working?
Section titled “Still not working?”Work through it in this order:
- Confirm the account is professional (Business or Creator), not personal.
- Confirm Allow access to messages is on.
- On the Facebook route only, confirm the Page and the Instagram account are in the same Business portfolio and that you’re a Page admin.
- Refresh permissions from scratch — Instagram automation not working.
If it survives all four, contact support@linktodm.com with your Instagram username, which route you connected on, and the time you last tried.