Policy Insights · Marketing API

Meta Marketing API v27.0: two defaults that switch on unless your tool opts out, and the dates behind them

Policy Insights ~3 min read
KEY TAKEAWAY

Since 4 November 2026, Meta’s Marketing API v27.0 can turn on Product showcase and “Reach more people across other mobile devices” for new ads and ad sets unless the integration opts out; the device default and a Lookalike location change reach all API versions about 90 days later (Meta says February 2027, date to be confirmed), and Graph API v21.0 is removed on 21 January 2027.

What changed on 4 November 2026

Meta for Developers published "Introducing Graph API v27.0 and Marketing API v27.0" on November 4, 2026. The post says the release includes "new capabilities, deprecations, and breaking changes." Most changes apply to calls made on v27.0. Some reach every version later. This article covers the ones that change ad delivery or break tools.

Default 1 — device expansion on new Sales ad sets

Meta's v27.0 changelog says that when you create an eligible ad set without the device setting, "Reach more people across other mobile devices is now turned on." Meta "can then deliver your ads to people on other mobile devices and operating systems when that is likely to improve performance." An ad set is eligible when it belongs to a Sales campaign that does not use the Mobile App conversion location and its targeting includes devices or operating systems. It is unavailable for Special Ad Categories. To keep delivery to the devices you targeted, the tool must set device to 0. Existing ad sets are not changed. The changelog says this "Will apply to all versions approximately 90 days after the v27.0 launch, date to be confirmed"; the blog post gives "February 2027."

Default 2 — Product showcase on new ads

On v27.0, when a creative has no Product showcase settings, "Meta may now turn on Product showcase." Meta says it does this "only when it has high confidence that a specific product set in your catalog matches the ad," and it "will not select the catalog's All Products set." The setting stays on the creative, so later ads that reuse that creative also have Product showcase on. The opt-out is product_extensions.enroll_status = OPT_OUT in the creative features spec. Meta also documents a preview endpoint that shows which product set it may use. Versions before v27.0 do not change.

Two breaking changes for tools

First, Lookalike audiences: on v27.0, requests that include country or location_spec in lookalike_spec "are rejected immediately," and the other versions follow about 90 days later (date to be confirmed). Existing Lookalike audiences keep delivering. Second, the catalog /{catalog-id}/batch endpoint is deprecated in favour of /items_batch and no longer works on v27.0+.

Version retirement dates

Meta's post says Graph API v21.0 "is deprecated and removed on January 21, 2027," and v22.0 on May 20, 2027. The Graph API changelog version table lists the same dates.

What to check

Ask whoever runs your ad tool, script, or agency integration which Marketing API version it calls. If it moves to v27.0, check whether it sends device: 0 where you need strict device targeting and OPT_OUT where you do not want catalog products shown under the ad. Look at new Sales ads after an upgrade, and do not read device-targeted results as device-only if expansion is on. Put 21 January 2027 (Graph API v21.0 removal) on the calendar. Treat the approximate February 2027 date as unconfirmed until Meta publishes a date. Meta's posts describe API behaviour. They do not say whether Ads Manager screens change the same way, so check the screen you actually use.

This article summarises Meta for Developers pages. It is not official Meta guidance. Follow the live changelog.