Version 23.0

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:

• GET /{ad-campaign-id}
• GET /{ad-account-id}/campaigns

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_estimate
• POST /{ad-account-id}/adsets
• POST /{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_estimate
• POST /{ad-account-id}/adsets
• POST /{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}/reachfrequencypredictions
• POST /{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:

• GET /{product-item-id}

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 is delayed.

The following endpoints are affected:

• POST /{ad-account-id}/adsets
• POST /{ad_set_id}

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 is delayed.

The following endpoints are affected:

• GET /{custom_audience_id}