Ads and Commerce
2026 Out-Of-Cycle Changes
Updated: May 8, 2026
2026 out-of-cycle changes to Marketing API.
May 8, 2026
Ads Insights API -- Breakdown availability changes
Applies to all API versions, effective August 3, 2026.
Beginning August 3, 2026, the following Ads Insights API breakdowns will require opt-in for certain ad accounts:
breakdowns=impression_device(including any combination that containsimpression_device)breakdowns=hourly_stats_aggregated_by_audience_time_zonebreakdowns=frequency_value
What’s changing
Synchronous API requests using these breakdowns may return no results for ad accounts that have not opted in. This applies to non-sales-supported accounts only; sales-supported accounts are unaffected.
How to maintain access
| Path | Details |
|---|---|
Opt in via Ads Manager | Account administrators can request access to these breakdowns directly in Ads Manager. Once opted in, synchronous API calls will continue to work as expected. |
Use asynchronous API jobs | Asynchronous report jobs remain available for all your history as long as you opted in. Async jobs are subject to the standard throttling quota: min(10, number_of_ad_groups) per 24 hours. |
The following endpoints are affected:
GET /{ad-campaign-id}/insights
Recommended action
If your application depends on any of the breakdowns listed above, update your integration to (a) handle the case where synchronous calls return no results, (b) prompt affected advertisers to opt in through Ads Manager, or (c) fall back to asynchronous report jobs.
For questions, see the Ads Insights API Breakdowns documentation or Developer Support.
May 4, 2026
Performance Recommendations
Applies to all versions.
The
lift_estimate field in the recommendation object now incorporates a new data source to provide personalized insights for eligible campaigns. This change applies to a subset of campaigns where the new data source is available; campaigns without coverage will continue to return existing values. No action is required from developers.See Performance Recommendations for more information.
April 30, 2026
Add audience labels to Customer File Custom Audiences, Website Custom Audiences, and Mobile App Custom Audiences
Applies to all versions.
Adding a new
audience_labels field to Customer File Custom Audiences, Website Custom Audiences, and Mobile App Custom Audiences. Labels categorize your audiences (for example, HIGH_VALUE_CUSTOMERS, QUALIFIED_LEADS) so they can be found and used for your ads more effectively.The following endpoints are affected:
POST /{ad-account-id}/customaudiences
April 21, 2026
Threads Ads
- Page-backed Threads accounts are now available for creating Threads ads. See Page-backed Threads accounts for more information.
- Existing Facebook and Instagram posts can be promoted for creating Threads ads. See Promote Existing Posts as Threads Ads for more information.
March 30, 2026
Partnership Ads
Account-Level Permissioning
Applies to all versions.
The
/{business-account-id}/branded_content_ad_permissions endpoint now supports filtering by creator_username, allowing you to search and retrieve ad permissions for a specific creator. See Account-Level Permissioning for more information.Ad Codes
Applies to all versions.
Creators can now generate partnership ad codes through the API, enabling automated workflows for branded content authorization without requiring manual steps in the Instagram app. See Ad Codes for more information.
March 25, 2026
Threads Ads
- You can now view, hide, and respond to replies on your Threads ads. See Reply Moderation for more information.
February 17, 2026
Threads Ads
- App ads are now available for Threads ads. See Threads App Ads for more information.
Did you find this page helpful?
