2026 Out-Of-Cycle Changes

Updated: Jul 20, 2026

Copy for LLM

Ads in WhatsApp Status are available via the Marketing API. Learn more about ads in WhatsApp Status.

2026 out-of-cycle changes to Marketing API.

July 20, 2026

Profile visit optimization

Applies to all versions.

You can now create ads that optimize for Instagram profile and Facebook Page visits through the Marketing API. Set the ad set optimization_goal to PROFILE_VISIT or PROFILE_AND_PAGE_ENGAGEMENT, and set destination_type to INSTAGRAM_PROFILE, FACEBOOK_PAGE, or INSTAGRAM_PROFILE_AND_FACEBOOK_PAGE.

For a single destination, set the ad creative call_to_action_type to match the ad set destination_type: VIEW_INSTAGRAM_PROFILE for INSTAGRAM_PROFILE or VISIT_PROFILE for FACEBOOK_PAGE.

For ads that drive to both an Instagram profile and a Facebook Page (destination_type = INSTAGRAM_PROFILE_AND_FACEBOOK_PAGE), provide an asset_feed_spec on the ad creative with optimization_type set to UNIFIED_PROFILE_VISIT_DESTINATION and two entries in call_to_actions: VIEW_INSTAGRAM_PROFILE (Instagram) and VISIT_PROFILE (Facebook).

See Profile Visit Ads for more information.

The following endpoints are affected:

POST /act_{ad-account-id}/adsets

POST /act_{ad-account-id}/adcreatives

POST /act_{ad-account-id}/ads

June 28, 2026

Advantage+ creative: Image Animation

Applies to all versions.

Image Animation is now available as an Advantage+ creative enhancement through the Marketing API. When enabled, a static image in your ad is automatically transformed into a short, subtly animated video to make your creative more engaging. Opt in to or out of this feature per creative through the image_animation field in degrees_of_freedom_spec.creative_features_spec.

See Get Started with Advantage+ Creative for more information.

The following endpoints are affected:

POST /act_{ad-account-id}/adcreatives

POST /act_{ad-account-id}/ads

Advantage+ creative: Video Filter

Applies to all versions.

Video Filter is now available as an Advantage+ creative enhancement through the Marketing API. When enabled, a visual enhancement is automatically applied to your video creative — for example, improving color or converting standard dynamic range (SDR) video to high dynamic range (HDR) — to make it more visually appealing. Opt in to or out of this feature per creative through the video_filtering field in degrees_of_freedom_spec.creative_features_spec.

See Get Started with Advantage+ Creative for more information.

The following endpoints are affected:

POST /act_{ad-account-id}/adcreatives

POST /act_{ad-account-id}/ads

Advantage+ creative: Video Uncrop

Applies to all versions.

Video Uncrop is now available as an Advantage+ creative enhancement through the Marketing API. When enabled, your video is automatically expanded (uncropped) to better fit the aspect ratio of additional placements — for example, filling vertical, full-screen surfaces instead of cropping or letterboxing your video. Opt in to or out of this feature per creative through the video_uncrop field in degrees_of_freedom_spec.creative_features_spec.

See Get Started with Advantage+ Creative for more information.

The following endpoints are affected:

POST /act_{ad-account-id}/adcreatives

POST /act_{ad-account-id}/ads

June 22, 2026

Transitioning from Nielsen DMAs to Comscore Markets

Applies to all versions.

Effective June 22, 2026, we are transitioning from Nielsen Designated Market Areas (DMAs) to Comscore Markets across ads targeting and reporting solutions. When requesting market-level data via the Ads Insights API, breakdowns=dma will no longer be supported; to retrieve market-level data, please instead use breakdowns=comscore_market.

For more information about Comscore Markets, please see our Help Center⁠.

The following endpoints are affected:

GET /{ad-object-id}/insights

POST /{ad-object-id}/insights

June 11, 2026

Creator Marketplace

Applies to all versions.

The Creator Marketplace API now includes several new capabilities for discovering and evaluating creators:

Expanded filtering: New follower count filters (100k-250k, 250k-1M, and 1M+) and US state-level filtering are now available for both creators and audiences.

Tailored creator recommendations: A new recommendation_type filter returns curated sets of creators based on specific criteria: most relevant for me, high ad performance, most ads experience, similar brands, and similar audience.

Creator badges: A new badges field is available when querying creator profile.

Thumbnail URL: A new thumbnail_url field is available when querying creator media.

Ads Manager integration: You can now discover creators whose followers closely match a saved Custom or Lookalike audience from Ads Manager, searching saved audiences by name or audience ID. Agencies pass their own business ID via the acting_business_id parameter to use a client’s audiences.

See Creator Marketplace API for more information.

June 1, 2026

IG Audio Swap for Instagram Reels Ads

Applies to all versions.

New parameters on POST /act_{id}/advideos to replace copyrighted music on Instagram Reels with royalty-free audio from Meta’s Sound Collection. Pass source_instagram_media_id with selected_audio_spec to create an ad video asset with swapped audio.

New replace_audio_status and selected_audio_spec fields on GET /{ad-video-id} to poll async audio swap completion. Check replace_audio_status until it returns SUCCESSFUL before using the swapped video in ad creative creation.

The following endpoints are affected:

POST /act_{id}/advideos

GET /{ad-video-id}

May 8, 2026

Ads Insights API -- Breakdown Availability Changes

Applies to all API versions, effective August 6th, 2026.

Beginning August 6th, 2026, the following Ads Insights API breakdowns will require enablement for certain Ad Accounts:

breakdowns=impression_device (including any combination that contains impression_device)

breakdowns=hourly_stats_aggregated_by_audience_time_zone

breakdowns=frequency_value

What’s changing

API requests using these breakdowns may return no results for Ad Accounts that have not enabled them, whether synchronous or asynchronous.

How to maintain access

Path	Details
Enable via Ads Manager	Account administrators can request access to these breakdowns directly in Ads Manager. Once enabled, synchronous API calls will continue to work as expected from that day onwards.
Use asynchronous API jobs	After enabling, asynchronous report jobs return your full history. Async jobs are subject to the standard throttling quota: `min(10, number_of_ad_groups) per 24 hours`.

Recommended action

If your application depends on any of the breakdown listed above, update your integration to (a) handle the case where requests return no results, (b) prompt affected advertisers to enable the breakdown through Ads Manager, and (c) once enabled, use asynchronous report jobs to retrieve historical data.

For questions, visit 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.