Ads and Commerce
Version 22.0
Updated: Feb 11, 2026
Marketing API
January 21, 2025 | Available until February 19, 2026 |
Ad Creatives
Applies to v22.0+. Will apply to all versions September 9, 2025.
Field Deprecations
The
instagram_actor_id field for the following endpoints is deprecated:POST /{ad-account-id}/adcreativesPOST /{ad-account-id}/adsPOST /{ads-id}POST /{ad-account-id}/asyncadrequestsetsGET /{ad-account_id}/generatepreviewsGET /generatepreviewsGET /adcreativeGET /adcreative/object_story_spec
Please migrate your API calls to use the new
instagram_user_id field.The
effective_instagram_story_id field has been deprecated for the GET /adcreative endpoint. Use the effective_instagram_media_id field instead.The
instagram_story_id field has been deprecated for the GET /adcreative endpoint. Use the source_instagram_media_id field instead.Advantage+ Creative
Standard Enhancements
Applies to v22.0+.
The following endpoints are affected:
POST /{ad-account-id}/adcreativesPOST /{ad-account-id}/adsGET /{ad-id}/previewsGET /{ad-account-id}/generatepreviews
Asset Feed Spec
Segment Asset Customization
Applies to v22.0+.
Segment Asset Customization is no longer supported.
Audiences
Detailed Targeting - Employer Exclusions
Applies to all versions.
An employer exclusion can now be created at the ad account level, which will be applied to all active campaigns.
The following endpoints are affected:
Detailed Targeting - Exclusions
Applies to v22.0+. Will apply to all versions April 21, 2025.
- When creating or updating an ad set, an error message will be shown when adding any new detailed targeting exclusions that are not within audience control exclusions at the account level.
- When duplicating an ad set, detailed targeting exclusions (except audience control exclusions at the account level) will be removed in the new campaign.
- When trying to get a delivery estimate, only employer exclusions will be allowed for detailed targeting.
As a result of this change, custom audiences will be deprecated within the
exclusions field. You can still continue using custom audience exclusions by using the excluded_custom_audiences field instead. For more details see Advanced Targeting: Custom Audiences.The following endpoints are affected:
POST /{ad-account-id}/adsetsPOST /{adset-id}POST /{adset-id}/copiesGET /{ad-account-id}/delivery_estimate
Reach People Interested in Selected Cities and Regions
Applies to v22.0+.
Expands location targeting beyond an ad campaign’s target cities or regions to deliver ads to people who have shown interest in a location.
The following endpoints are affected:
Commerce Platform
Promotions API – field deprecation
Applies to v22.0+.
The
promotions field has been deprecated and replaced by the promotion_details field. Please discontinue using the promotions field, as it does not contain complete information. Please migrate your API calls to the new promotion_details field.The following endpoint is affected:
Instagram Endpoints
Applies to v22.0+. Will apply to all versions April 21, 2025.
The Instagram endpoints supported by the Marketing API have been deprecated.
The following endpoints are affected:
DELETE /{instagram-comment-id}GET /{instagram-carousel-id}GET /{instagram-carousel-id}/commentsGET /{instagram-comment-id}GET /{instagram-comment-id}/repliesGET /{instagram-media-id}GET /{instagram-media-id}/commentsGET /{instagram-user-id}GET /{instagram-user-id}/agenciesGET /{instagram-user-id}/ar_effectsGET /{instagram-user-id}/authorized_adaccountsGET /{instagram-user-id}/upcoming_eventsPOST /{instagram-user-id}/authorized_adaccountsPOST /{instagram-carousel-id}/commentsPOST /{instagram-comment-id}POST /{instagram-comment-id}/repliesPOST /{instagram-media-id}POST /{instagram-user-id}/upcoming_events
Please migrate your API calls to use the following Instagram Platform endpoints:
Special Ad Categories
We are providing an update regarding the previously considered restrictions on customer list custom audiences (CLCAs) for advertisers offering housing, employment, and financial products and services in or targeting audiences in the United States.
The rollout of these previously announced restrictions will not proceed.
Certain customer list custom audiences will become ineligible for usage in ad sets of housing, employment, and financial products and services, including credit, campaigns beginning March 2025. Learn more about the update here and whether the restrictions apply to you.
Ad Sets for Special Ad Category Campaigns
Applies to v22.0+. Will apply to all versions March 2025.
Starting with v22.0, you will be unable to create or update ad sets if their targeting options contain one or more ineligible customer list custom audiences. You will need to either certify if eligible or remove any such audiences to successfully create or update the ad set. Starting early April 2025, existing campaigns/ad sets using customer list custom audiences which do not follow the requirements may be paused. If this happens, you will see errors in Ads Manager and the Marketing API with instructions.
The
is_sac_cfca_terms_certified field will be added to the ad set API. You will be required to use this field to certify that any customer list custom audiences being used in an ad set of a housing, employment, and financial products and services, including credit, campaign comply with Meta’s CLCA certification.This change affects the following endpoints when creating or updating ad sets:
Custom Audiences
Applies to all versions.
Starting on January 6, 2025, you can use the new
is_eligible_for_sac_campaigns field to identify whether a custom audience can be used in ad sets of Special Ad Category campaigns. You must provide the intended special_ad_categories and special_ad_category_countries of the Special Ad Category campaign using the audience, as well as the ad_account_id which will use the audience to create or edit the ad set.This change affects the following endpoints:
See Special Ad Categories for more information about these changes.
Did you find this page helpful?
