Meta Graph API Deprecations: A Dated Timeline for Instagram, Facebook, and Threads
A verified, dated timeline of what Meta has actually deprecated or changed across the Instagram, Facebook, and Threads publishing APIs, sourced from Meta's own changelogs.
The key dated Meta deprecations, from Meta's own changelogs: the VIDEO media_type was removed November 9, 2023 (video publishing moved to REELS); the Instagram Basic Display API ended December 4, 2024; unprefixed Instagram Login scopes were deprecated January 27, 2025; and legacy Instagram v1.0 endpoints retired April 21 – May 20, 2025. Graph API versions themselves retire on a rolling roughly-two-year schedule.
Meta changes the Graph API, the Instagram Platform, and the Threads API more often than most integrations are built to tolerate, and a lot of what circulates about "Instagram API deprecations" online is recycled speculation rather than dated fact. What follows is a timeline built only from Meta's own published changelogs — every entry below is dated and sourced, and anything we couldn't verify against Meta's own documentation was left out rather than guessed at.
PostGate handles OAuth, publishing and delivery evidence for every network through one API. Start free or read the docs.
Instagram content-publishing timeline
- November 9, 2023 — the
VIDEOvalue formedia_typewas removed from Instagram content publishing (announced June 28, 2022, over a year ahead of the cutover). Video publishing moved tomedia_type: REELS, which is why every current video-publish integration builds a Reels container rather than a plain video one. - December 4, 2024 — the Instagram Basic Display API reached full end of life. It had already been the only path for personal (non-professional) Instagram accounts; after this date there is no official API access for personal accounts at all, only Business and Creator accounts through the Instagram Platform.
- January 27, 2025 — the original, unprefixed Instagram Login scope names (
business_basic,business_content_publish, and related scopes) were deprecated, three months after Meta announced the change on September 17, 2024. Replacements use aninstagram_prefix —instagram_business_basic,instagram_business_content_publish,instagram_business_manage_comments, andinstagram_business_manage_messages. - April 21 – May 20, 2025 — legacy Instagram v1.0 API endpoints (user, media, comment, and carousel endpoints predating the current content-publishing flow) were retired in a phased rollout, starting with v22.0 and later apps on April 21 and reaching every app by May 20. Meta announced the window on January 21, 2025.
- June 14, 2025 — the Business Login parameters
enable_fb_loginandforce_authenticationwere deprecated in favor of a singleforce_reauthparameter.
Full detail lives in Meta's Instagram Platform changelog.
Threads API timeline
- June 18, 2024 — the
sinceanduntilparameters stopped being supported when fetching thefollowers_countmetric on/threads_insights. - October 11, 2024 — tag formatting rules changed: a hash symbol followed immediately by a number (like
#1) no longer converts to a clickable tag, and the list of unsupported special characters in tags was updated. - November 20, 2025 — the follower threshold for profile discovery was lowered from 1,000 to 100 followers.
- December 22, 2025 — posts containing more than five links began failing with
THREADS_API__LINK_LIMIT_EXCEEDED, a new hard cap. - March 31, 2026 — Tenor API support for GIF publishing was sunset (announced February 27, 2026), in favor of GIPHY as the supported GIF source.
Source: Meta's Threads API changelog.
The Graph API version clock keeps moving underneath all of it
Separate from feature-level deprecations, Graph API versions themselves retire on a rolling schedule. As of this writing, Meta's Graph API changelog lists v26.0 as the current version (released July 29, 2026), with v19 scheduled to retire on May 21, 2026 and v20 on September 24, 2026. Meta typically supports a given major version for roughly two years from release before retiring it — plan to move off a version well before its published retirement date, not the week of.
When did the Business Verification requirement take effect?
One access-model change worth knowing the date on: as of February 1, 2023, apps requesting Advanced Access to most permissions must complete Meta Business Verification before App Review will grant it. This is the rule that catches teams who prepare a strong App Review submission but never started the separate business-verification process — see Meta Advanced Access, explained for what that process actually involves.
How do you stay ahead of the next one?
None of this is exotic — Meta publishes every one of these changes in advance, in the changelogs linked above. The practical failure mode is not that a change was hidden; it's that nobody on the integration side was watching. If you're building directly against the Graph API, bookmark the Instagram Platform and Threads changelogs and check them on a schedule rather than after something breaks. PostGate's adapter layer absorbs a meaningful share of this churn — version bumps, renamed scopes, and endpoint retirements get handled centrally rather than in each integration — see the current per-platform limits in the platform guides.
Frequently asked questions
When was the Instagram Basic Display API shut down?
December 4, 2024 — full end of life. It had already been the only path for personal (non-professional) Instagram accounts, so after that date there is no official API access for personal accounts at all. Only Business and Creator accounts remain supported, through the Instagram Platform.
Why do Instagram videos have to be published as Reels?
Because the VIDEO value for media_type was removed from Instagram content publishing on November 9, 2023 — a change Meta announced on June 28, 2022, over a year ahead of the cutover. Video publishing moved to media_type: REELS, which is why every current video-publish integration builds a Reels container rather than a plain video one.
How long does Meta support a Graph API version?
Meta typically supports a given major version for roughly two years from release before retiring it. As of this writing, the Graph API changelog lists v26.0 as current (released July 29, 2026), with v19 scheduled to retire on May 21, 2026 and v20 on September 24, 2026. Plan to move off a version well before its published retirement date.
What recently changed in the Threads API?
Three notable dated changes: on November 20, 2025 the follower threshold for profile discovery was lowered from 1,000 to 100; on December 22, 2025 posts with more than five links began failing with THREADS_API__LINK_LIMIT_EXCEEDED; and on March 31, 2026 Tenor API support for GIF publishing was sunset in favor of GIPHY as the supported GIF source.
How do I keep my integration ahead of Meta API deprecations?
Meta publishes every one of these changes in advance, in its Instagram Platform, Threads, and Graph API changelogs — the practical failure mode is that nobody on the integration side was watching. Bookmark the changelogs and check them on a schedule rather than after something breaks. An adapter layer like PostGate's absorbs version bumps, renamed scopes, and endpoint retirements centrally.
