Introducing Graph API v25.0 and Marketing API v25.0

Summary

Meta's V25 Graph API and Marketing API update brings significant changes for ad operations. The new Page Viewer Metric, arriving by June 2026, replaces legacy reach metrics across page and story insights, aiming for consistent cross-platform measurement. Developers should migrate from usage of `page_impressions_unique*` and similar endpoints to `page_total_media_view_unique` and `post_total_media_view_unique`.

Webhooks mTLS certificates will be signed by Meta's own CA starting March 31, 2026; failure to update trust stores with the new root CA (`meta-outbound-api-ca-2025-12.pem`) will cause TLS handshake failures. Enhanced error messaging for Ads Insights Async API begins Feb 18, 2026, adding fields like `error_code`, `error_message`, `error_subcode`, `error_user_title`, and `error_user_msg` to failed report runs, with `error_code` changing from uint to int. The `metadata=1` query parameter is deprecated from v25 and will be removed in May 2026.

Deprecations of reach/impression and 3-second viewer metrics are scheduled for June 2026, pushing adoption of Media Views and Media Viewers. For paid/organic breakdowns, `page_media_view` and `post_media_view` are recommended. Marketing API sees deprecation of ASC and AAC campaigns: creation/update stops Feb 18, 2026, and all such campaigns will be paused by Sep 2026.

ECBC (Existing Customer Budget Caps) campaigns remain editable until v26.0, with options for manual duplication, API replication, or bulk migration. Finally, Graph API versions v19 and v20 are deprecated on May 21, 2026 and Sep 24, 2026 respectively, urging migration to the latest version. Key action items: update webhook trust stores by March 31, 2026; migrate from legacy metrics to Media Views/Viewers by June 2026; prepare for ASC/AAC deprecation by moving to Advantage+; and plan for version upgrades.

Analyst Note

The breadth of deprecations in Meta’s V25 signals a coordinated push toward a unified, cross-platform measurement framework. The retirement of reach, impression, and 3-second view metrics in favor of ‘media viewers’ and ‘media views’ aligns with industry shifts away from legacy ad-serving proxies toward attention-based, person-level counting. For UA managers and monetization strategists, this means historical comparison baselines will break, and any dashboards built on endpoints like page_impressions_unique or video_insights will require migration by mid-2026.

The simultaneous enforcement of Advantage+ as the default campaign setup (via ASC/AAC deprecation) removes advertiser control over automation opt-out, echoing broader platform trends where algorithmic optimization becomes mandatory. The error enhancement for Ads Insights Async API is a rare quality-of-life win, though it suggests Meta anticipates more frequent async failures as reporting complexity increases. Notably, the certificate authority change for webhooks mTLS is a reminder that infrastructure hygiene matters—missed trust store updates could silently break event delivery.

With v19 and v20 also set for removal, this update cycle demands resource allocation for both metric migration and campaign restructuring, compressing timelines for ad tech teams already managing privacy-related changes.