Your Instagram API Integration Is Broken — and the Account Type Is Why
The Instagram Graph API does not support personal accounts. It never did in its current form, and since December 4, 2024, there is no fallback. The Basic Display API — which provided read-only access to personal Instagram accounts — has been permanently shut down. Every Instagram API integration in 2026 requires a Professional account (Business or Creator). If the account your app is trying to serve is a personal profile, the API will refuse to connect — and that error will not go away until the account type changes and the correct permissions are obtained through App Review.
What Triggered This Problem: The December 2024 Basic Display API Shutdown
Prior to December 4, 2024, developers could use the Instagram Basic Display API to access personal account data through a simple OAuth flow. On that date, Meta permanently shut it down with no replacement for personal accounts. The Basic Display API was retired on December 4, 2024, and our Instagram Basic Display API deprecation guide covers what broke and how migration works. The only remaining official path is the Instagram Graph API, which exclusively serves Instagram Professional accounts (Business or Creator). Any integration that was relying on the Basic Display API for personal accounts has been broken since that date and cannot be fixed by refreshing tokens — the API no longer exists.
The Two API Paths — and What Account Type Each Requires
Instagram API with Instagram Login
Your app users log in with Instagram credentials. Serves both Business and Creator Professional accounts. Facebook Page is not required. This is the simpler path for Creator-account tools. Choosing between the two login paths shapes the whole build, and our Instagram Login vs Facebook Login guide breaks down hosts, tokens, and permissions for each. Available permissions include instagram_business_basic, instagram_business_content_publish, instagram_business_manage_comments, and instagram_business_manage_messages. All endpoints accessed via graph.instagram.com.
Instagram API with Facebook Login for Business
Your app users log in with Facebook credentials. The Instagram Professional account must be linked to a Facebook Page, and the user must hold admin-equivalent tasks on that Page. Enables additional features not available in the Instagram Login path: hashtag search, product tagging, partnership ads, Messenger-based Instagram messaging. Endpoints via graph.facebook.com.
Symptoms That Point to a Personal Account Problem
- Empty data set or authentication error after OAuth completes — the token issued but cannot retrieve account data because the account is personal and cannot grant Graph API permissions
- "This account type is not supported" or similar error on publishing, insights, or messaging endpoints — the account type does not satisfy the API's Professional account requirement
- OAuth screen completes but no usable token scope is received — personal accounts cannot grant any of the Graph API permissions your app is requesting
- Integration worked before December 2024 but now fails — the Basic Display API token it relied on is permanently invalid and cannot be renewed under any path
- "Account not linked to a Page" on the Facebook Login path — the account is Professional but has not been connected to a Facebook Page in Instagram Settings, which is required for that login path
The Conversion Path: Personal to Professional Account
Creator vs Business Account: Which One to Use
| Factor | Creator Account | Business Account |
|---|---|---|
| Facebook Page required | No (Instagram Login path) | Yes (Facebook Login path) |
| Content publishing permission | Yes | Yes |
| Comment moderation permission | Yes | Yes |
| Messaging permission | Yes (Instagram Login) | Yes |
| Hashtag Search API | Not available | Yes (Facebook Login) |
| Product Tagging | Not available | Yes (Facebook Login) |
| App Review required to serve client accounts | Yes — Advanced Access | Yes — Advanced Access |
Account Conversion Solves the First Gate — App Review Is the Next One
Switching to a Professional account removes the account-type barrier. But if your app needs to serve Instagram Professional accounts that you do not own or manage — real client accounts, not just test accounts — Standard Access is insufficient. Standard Access only covers accounts where the authenticated user has a role on your Meta app itself. To serve external clients, every permission your app uses must be approved for Advanced Access through Meta App Review, and your app's Business Portfolio must complete Meta Business Verification. The account conversion is the starting point; App Review is what unlocks the app for production use with real clients.
Common Mistakes That Stall the Project After Conversion
- Testing with a Development Mode app against real client accounts — Standard Access in Development Mode only permits accounts that have a role on the app to authorize. Real client accounts without a test-user role will return empty data sets even after converting to Professional type
- Requesting Advanced Access before Business Verification is complete — Business Verification is a prerequisite for the App Review submission that grants Advanced Access; submitting without it will block the review
- Using the Facebook Login path with a Creator account not linked to a Facebook Page — produces the same connection failure as a personal account until the Page is connected and the user has the correct task-level access on it
- Reusing old Basic Display API tokens — tokens issued before December 4, 2024 cannot be refreshed and will not work on any Graph API endpoint; fresh OAuth authorization against the new Professional account is required
For a full guide to the Instagram Graph API Advanced Access approval process and what permissions require App Review, see the Instagram API Advanced Access Approval Guide. If your app also reads follower or engagement analytics, the instagram_manage_insights permission approval guide covers the insights-specific App Review requirements. For done-for-you Instagram App Review submission support covering all the permissions your app requires, see the Instagram App Review service. For the Meta Business Verification requirement that must be completed before Advanced Access can be approved, see the Meta Business Verification Guide.