The new GAPI/MAPI V25 update introduces significant changes and deprecations planned through 2026, focusing on improving metrics consistency, security, error reporting, and automation.
General Updates
- Graph API: Page Viewer Metric will replace the legacy reach metric by June 2026, providing a unified measurement across Facebook and Instagram. New viewer metrics will be accessible via page and story insights endpoints.
- Webhooks mTLS Certificate Update requires developers to update their trust stores by March 31, 2026, to trust a new Meta internal Certificate Authority. Failure to do so will cause TLS handshake failures and stop webhook event delivery.
Deprecations & Breaking Changes
- Enhanced Error Messaging for Ads Insights Async API (from Graph API V25.0, Feb 18, 2026) introduces detailed error fields (
error_code,error_message,error_subcode,error_user_title,error_user_msg) to improve failure diagnostics. Theerror_codetype changes fromuinttoint. - Metadata Query Parameter Deprecated: The
metadata=1query parameter will be ignored starting with Graph API v25 (Feb 2026) and removed by May 2026. Developers should use official API documentation for metadata. - Page Reach/Impressions Metrics Deprecation: Post/Page Reach, Video Impressions, and Story Impressions metrics will be deprecated in June 2026. Developers should migrate to new Media Views and Media Viewers metrics.
- 3-second Viewers Metrics Deprecation: Also deprecated in June 2026, replaced by Media Views and Media Viewers metrics for consistent measurement.
Marketing API Changes
- ASC and AAC Campaigns Deprecation: From V25.0 (Feb 18, 2025), creation and update of ASC and AAC campaigns via Marketing API are disabled, extending to all MAPI versions by May 19, 2026. By V26.0 (Sep 2026), remaining ASC and AAC campaigns will be paused.
- Campaigns using Existing Customer Budget Caps (ECBC) remain editable until V26.0. Developers should replicate ECBC campaigns before then via manual duplication, API guidance, or bulk migration requests.
API Version Deprecations
- Graph API v19 will be deprecated on May 21, 2026.
- Graph API v20 will be deprecated on September 24, 2026.
- Developers are advised to migrate all calls to the latest API versions to avoid disruptions.
These updates emphasize migration to newer metrics and APIs, updating security certificates, and adapting to improved error reporting and automation frameworks. Developers should review the Graph API Changelog and updated documentation for detailed guidance.
