Appearance
Fresh 2026
Version 19.0
Updated:May 29, 2025
Marketing API
| January 23, 2024 | Available until February 4, 2025 | Blog post |
Insights
Ads Insights
Applies to v19.0+.
The age_targeting, gender_targeting, labels, and location insights metrics will no longer be available. The estimated_ad_recall_rate_lower_bound, estimated_ad_recall_rate_upper_bound, estimated_ad_recallers_lower_bound, and estimated_ad_recallers_upper_bound insights metrics will no longer be available.
The following endpoints are affected:
GET /{ad-set-id}/insightsGET /{ad-account-id}/insightsGET /{ad-id}/insightsGET /{campaign-id}/insightsPOST /{ad-set-id}/insightsPOST /{ad-account-id}/insightsPOST /{ad-id}/insightsPOST /{campaign-id}/insights
Objectives
Ad Copies
Applies to v19.0+.
When creating a copy of an ad you must only use Outcome-Driven Ad Experience objectives. Attempting to use legacy objectives will result in an error.
The following endpoints are affected:
POST /{adgroup-id}/copiesPOST /{ad-campaign-id}/copiesPOST /{ad-campaign-group-id}/copies
Targeting
Target Expansion
Applies to v19.0+. Will apply to all versions on April 22, 2024.
The targeting_optimization field will not be accepted for campaigns that are optimized for link clicks or landing page views. This also applies to previous optimizations that were included in Advantage Detailed Targeting with no option to opt-out including conversions, value, app installs, app events and conversations. For all optimizations that are opted into Advantage Detailed Targeting with no option to opt-out we will automatically set the targeting_as_signal field to either 1 or 3 based on the set of objectives and optimizations. The targeting_as_signal field should be either null or 0 for campaigns that are optimized for impressions, video views, reach, engagement, ad recall lift or lead, otherwise an error will be received.
The following endpoints are affected:
POST /act_{ad-account-id}/adsetsPOST /{adset-id}GET /{adset-id}/delivery_estimateGET /act_{ad-account-id}/delivery_estimate
V19.0 Changes
| File Name |
|---|
| api_specs/specs/AdAccount.json |
| api_specs/specs/AdAccountBusinessConstraints.json |
| api_specs/specs/AdCreativeBrandedContentAds.json |
| api_specs/specs/AdPromotedObject.json |
| api_specs/specs/AdVideo.json |
| api_specs/specs/AdsActionStats.json |
| api_specs/specs/AdsHistogramStats.json |
| api_specs/specs/AdsPixel.json |
| api_specs/specs/Application.json |
| api_specs/specs/Business.json |
| api_specs/specs/Canvas.json |
| api_specs/specs/CanvasPreview.json |
| api_specs/specs/CustomAudience.json |
| api_specs/specs/CustomAudienceSalts.json |
| api_specs/specs/DestinationCatalogSettings.json |
| api_specs/specs/GameItem.json |
| api_specs/specs/Group.json |
| api_specs/specs/IGMedia.json |
| api_specs/specs/InstantArticlesStats.json |
| api_specs/specs/Page.json |
| api_specs/specs/Profile.json |
| api_specs/specs/User.json |
| api_specs/specs/VideoCopyrightCheckStatus.json |
| api_specs/specs/VideoStatus.json |
| api_specs/specs/Page.json |
| api_specs/specs/VideoStatusError.json |
| api_specs/specs/VideoStatusProcessingPhase.json |
| api_specs/specs/VideoStatusPublishingPhase.json |
| api_specs/specs/VideoStatusUploadingPhase.json |
| api_specs/specs/WhatsAppBusinessAccount.json |
| api_specs/specs/WhitehatFBDLRun.json |
| api_specs/specs/enum_types.json |
Did you find this page helpful?
ON THIS PAGE
Marketing API
Insights
Ads Insights
Objectives
Ad Copies
Targeting
Target Expansion
V19.0 Changes