What changed: Meta rolled out Graph API v27.0 and Marketing API v27.0 on November 4, 2026. New apps can no longer use legacy features such as multi-ID requests, date/time formatting, HTTP method override, field aliases, JSONP callbacks, or asynchronous batch requests. The /{catalog-id}/batch endpoint is deprecated in favor of /{catalog-id}/items_batch. Lookalike audiences can no longer be created with a location in lookalike_spec and now inherit locations from the targeting ad sets. Eligible new Sales ad sets targeting specific mobile devices get 'Reach more people across other mobile devices' turned on by default unless device is set to 0. Meta may also automatically enable Product showcase on ads when a catalog product set is a high-confidence match. The total_video_consumption_rate video insights metric will no longer return data on any version starting early November 2026.
Who is affected
Developers, advertisers, and agencies integrating with Meta's Graph API and Marketing API, including advertiser businesses using the Catalog API.
What it means for your business
For businesses using Meta's Marketing API or Catalog API, this means certain API calls must be updated and new default ad settings reviewed.
What to do
Update your Catalog API integration to use /{catalog-id}/items_batch instead of /{catalog-id}/batch. Remove country and location_spec from lookalike_spec. Set device to 0 on mobile-targeted Sales ad sets if you want to keep current targeting. Set product_extensions.enroll_status to OPT_OUT if you don't want Product showcase enabled automatically. Stop using the listed legacy Graph API features before upgrading to v28.0.
When it takes effect
Changes took effect on November 4, 2026; the mobile-device targeting default and lookalike restriction extend to all remaining versions approximately 90 days later (date to be confirmed); total_video_consumption_rate stops returning data on all versions starting early November 2026; Graph API v21.0 is removed January 21, 2027, and v22.0 on May 20, 2027.
