Instagram Basic Display API Is Dead — Here’s What to Build Instead in 2026
In late 2025, we were integrating Instagram into a social media automation tool for Australian businesses. The tool needed to post content, read engagement, and manage a publishing queue across multiple accounts.
We chose Postiz as the scheduling backbone and got to work wiring up Instagram as a channel.
Two days later, we had not successfully authenticated a single account. The OAuth screen showed “Invalid platform app.” The redirect URL was getting client_id=undefined. Nothing in the logs made sense.
Then we found the note, buried in the Meta developer changelog.
Instagram Basic Display API was deprecated September 2024 and removed December 2024.
Every tutorial we had referenced, every Stack Overflow answer, every Postiz guide for Instagram standalone — all of it was built on an API that no longer existed.
What Was Instagram Basic Display API?
Instagram Basic Display API was the original developer-facing API for reading user media and profile information. It let apps authenticate as an individual Instagram user and access their posts, profile picture, follower count, and media.
For many years, it was the standard way to build Instagram integrations:
Instagram Basic Display API flow (deprecated):
────────────────────────────────────────────────
User → Your App → developers.instagram.com
│
└── OAuth authorisation
│
└── Access token
│
└── Read user posts
Read profile
Read mediaIt was simple, well-documented, and widely used.
Meta deprecated it in September 2024 and removed it entirely in December 2024. Any app registered on developers.instagram.com using Basic Display API stopped working at that point.
What the Error Looks Like
If you are building against the old API path, you will see one of these:
Symptom 1:
OAuth redirect URL contains:
?client_id=undefined&...
Cause: The app credentials are from an Instagram standalone
developer account (developers.instagram.com).
This credential type no longer issues valid tokens.
Symptom 2:
OAuth screen shows:
"Invalid platform app"
Cause: The app type (Basic Display) is no longer valid.
Meta will not process the authorisation.
Symptom 3 (Postiz specific):
Postiz Instagram (Standalone) channel
Always fails regardless of correct env vars
Cause: Postiz's standalone Instagram channel was built
on Basic Display API. It is non-functional.None of these errors tell you what actually happened. There is no message saying “this API is deprecated.” The failure is silent and confusing.
What Actually Works: Instagram Graph API via Facebook Login
The replacement is Instagram Graph API, accessed through a Facebook Business App and authenticated via Facebook Login — not Instagram Login.
This is a meaningful architectural difference:
Old path (broken):
─────────────────────────────────────────────
Instagram developer account
│
└── developers.instagram.com
│
└── Basic Display API
│
└── Instagram token ✗ NO LONGER WORKS
New path (working):
─────────────────────────────────────────────
Facebook developer account
│
└── developers.facebook.com
│
└── Facebook Business App
│
├── Facebook Login (OAuth)
│
└── Instagram Graph API
│
└── Manage Instagram posts ✓
Read engagement ✓
Schedule content ✓Your Instagram account must be either a Professional account (Business or Creator) and must be linked to a Facebook Page. Personal Instagram accounts cannot be managed via Instagram Graph API.
Setting Up the New Path: Step-by-Step
Here is what the setup looks like in 2026:
Step 1: Convert Instagram to a Business/Creator account
Instagram app → Settings → Account type
Switch to Professional Account
Choose: Business or Creator
(If already professional, skip)Step 2: Link to a Facebook Page
Instagram Settings → Linked Accounts → Facebook
Connect to a Facebook Page you manage
This link is required. Without it, the Graph API
cannot authenticate Instagram actions.Step 3: Create a Facebook Business App (not Instagram app)
developers.facebook.com → My Apps → Create App
App type: Business
(NOT: Consumer, which gives you Basic Display)
Add products to your app:
√ Facebook Login
√ Instagram API (under Instagram in the products list)Step 4: Configure OAuth redirect URIs
Facebook Login → Settings → Valid OAuth Redirect URIs
Add your callback URL:
https://yourapp.com/auth/instagram/callback
(Must match exactly what your app sends)Step 5: Configure permissions
App Review → Permissions and Features
Request:
instagram_basic → read profile
instagram_content_publish → create posts
instagram_manage_comments → read/respond to comments
pages_read_engagement → read page insights
Note: Advanced permissions require App Review
(instagram_content_publish needs Meta review)Step 6: App Review for Publishing
If you need posting capabilities:
Submit for App Review
Provide: screen recording of the flow
privacy policy URL
use case description
Timeline: 5–10 business days typically
Without review: read-only access works
With review: full posting capabilityThe Postiz Migration Path
If you are using Postiz and were trying to use the Instagram (Standalone) channel, here is what to do:
Remove: Instagram (Standalone) channel
(built on deprecated Basic Display API)
Add: Instagram via Facebook channel
(built on Instagram Graph API)
Configuration difference:
Old standalone:
INSTAGRAM_CLIENT_ID=...
INSTAGRAM_CLIENT_SECRET=...
(from developers.instagram.com — no longer valid)
New via Facebook:
FACEBOOK_APP_ID=... (from developers.facebook.com)
FACEBOOK_CLIENT_SECRET=...
Both credentials come from your Facebook Business App,
not from an Instagram-specific developer account.What This Means for Australian Businesses
If you have a social media tool, agency dashboard, or any integration that reads or posts to Instagram, you should check which API path it uses.
Signs your integration may be broken:
□ OAuth flow returns "Invalid platform app"
□ Access tokens suddenly stopped working (after Dec 2024)
□ Integration was working in 2023 or 2024, now fails
□ Developer account is registered at developers.instagram.com
(not developers.facebook.com)
□ Tool documentation mentions "Instagram Basic Display API"If any of these are true, your integration is running on a removed API and needs to be rebuilt against the Graph API path.
The Broader Lesson: Third-Party API Dependency
This incident highlighted a risk that applies to any integration with a platform-controlled API.
API Dependency Risk Framework:
High risk (deprecation likely):
─ APIs owned by large platforms (Meta, Google, Twitter/X)
─ APIs that give data access platforms want to monetise
─ APIs tagged "legacy" or "v1" while v2+ exists
─ APIs with declining developer documentation investment
Mitigation strategies:
─ Subscribe to platform developer changelogs
─ Add deprecation monitoring to your integration checklist
─ Build an abstraction layer (swap API behind interface)
─ Test integrations regularly, not just on changeMeta gave reasonable notice before removing Basic Display API. The problem was that the developer community’s documentation — tutorials, forum answers, third-party tools — lagged behind the deprecation by months. In December 2024, when the API was removed, the majority of search results still described the old path.
When building against a platform API, always check the official changelog date alongside the tutorial publication date. A tutorial from 2023 may be describing an API that no longer exists.
Summary
Instagram Basic Display API:
Status: REMOVED (December 2024)
Registered at: developers.instagram.com
What to use instead:
API: Instagram Graph API
Access via: Facebook Business App
Registered at: developers.facebook.com
Requires: Professional Instagram account
Linked to Facebook Page
App Review for publishing permissions
Migration time (for an existing integration):
~4–8 hours for setup + App Review submission
+ 5–10 days waiting for App Review if publishing neededIf you are an Australian business with an existing Instagram integration that stopped working, or if you are building a new one and want to avoid the 2-day debugging spiral we went through, Cosmos Web Tech’s development team can help you set up the correct API path from the start.
Related reading: Social Media Automation for Western Sydney Businesses: A Practical 2026 Guide
Your website’s performance depends on what’s behind it. Cloud Geeks provides the managed hosting, cloud, and IT support that keeps Australian SMBs online and secure.
Ash Ganda covers how Australian SMBs are using AI, automation, and digital strategy to grow without scaling costs proportionally.
If your business is also planning a customer-facing iOS or Android app — Awesome Apps builds cross-platform mobile apps for Australian SMBs.
Part of the Ganda Tech Services family, Cosmos Web Tech delivers specialist web design and digital marketing for Australian small and medium businesses.