Ads and Commerce
Ads and Commerce
Resources
Version 23.0
Updated: Jan 15, 2026
Marketing API
May 29, 2025 | Available until June 9, 2026 |
Ad Campaigns
Advantage+ Shopping Campaigns and Advantage+ App Campaigns
Applies to v23.0.+ Will apply to all versions with the release of v25.0.
The
advantage_state field in advantage_state_info is a read-only field that indicates if a campaign has reached an optimal level of automation. Beginning with v25.0, the smart_promotion_type field will no longer be available for creating ad campaigns.The following endpoints are affected:
Audiences
Advanced Targeting
Applies to v23.0+.
Age range and gender settings can now be used as suggestions in ad sets using individual_setting’s age and gender parameters inside targeting_automation.
Note: When using suggestions, your ads will reach people outside of the setting when it’s likely to improve performance of the ads.
The following endpoints are affected:
GET /{ad-account-id}/delivery_estimatePOST /{ad-account-id}/adsetsPOST /{adset-id}POST /{adset-id}/copies
Advantage+ Audience
Applies to v23.0+.
Ad sets are now opted-in to Advantage+ audience by default if you’re using the default or relaxed setup. You can opt-out in the audience settings when creating or updating an ad set.
This behavior applies only when creating a new ad set; updating an existing ad set will not exhibit this behavior on any version.
The following endpoints are affected:
GET /{ad-account-id}/delivery_estimatePOST /{ad-account-id}/adsetsPOST /{adset-id}POST /{adset-id}/copies
Bidding
Reservation
Applies to v23.0+.
Beginning with v23.0, the
instagram_destination_id field will return the ig_user_id rather than the instagram_actor_id. The instagram_actor_id is also no longer supported in the destination_ids parameter; update your API calls to use the ig_user_id instead.The following endpoints are affected:
GET /{rf-prediction-id}GET /{ad-account-id}/reachfrequencypredictionsPOST /{ad-account-id}/reachfrequencypredictions
Product Item
Videos
Applies to v23.0+.
The
videos field has been added to allow for querying of the properties of videos associated with product items.The following endpoints are affected:
Special Ad Catagories
Ad Sets for Special Ad Category Campaigns
Applies to v23.0. Will Apply to all versions August 27, 2025.
The
is_sac_cfca_terms_certified field should no longer be added to an ad set as the rollout of these requirements will not proceed.The following endpoints are affected:
Custom Audiences
Applies to v23.0. Will Apply to all versions August 27, 2025.
The
is_eligible_for_sac_campaigns field should no longer be added to an ad set as the rollout of these requirements will not proceed.The following endpoints are affected:
Did you find this page helpful?
