Version 20.0
Graph API
Released May 21, 2024 | Available until TBD | Blog Post
Comments
Applies to v20.0. Applies to all versions August 19, 2024.
Changed the permalink_url field on the Comment node. This field will not be returned in API responses for comments on posts on pages if the calling app has only the Page Public Content Access feature.
Error Codes
Applies to v20.0+.
The API will now return error code 200 instead of error code 2 when the calling app's user does not have permission to access a given field on a given object.
Instagram Graph API
Instagram User Insights
Applies to v20.0+. Will apply to all versions on August 19, 2024.
The last_14_days, last_30_days, last_90_days and prev_month timeframes will no longer be supported for the reached_audience_demographics and engaged_audience_demographics metrics.
The following endpoints and metrics are affected:
GET /{ig-user-id}/insightsengaged_audience_demographicsreached_audience_demographics
Messenger Platform
The Booking button is no longer supported in Messenger API calls. This change does not affect other templates and buttons, and businesses can still manage bookings using Meta Business Suite. We recommend reviewing your current integrations and adjusting your applications as necessary to ensure a smooth transition for your users.
WhatsApp Flows
Marketing API
Released May 21, 2024 | Available until May 6, 2025 | Blog Post
Offline Conversions API
Deprecation of Remaining Endpoints
Applies to v20.0+.
The Offline Conversions API will be discontinued in May 2025. It was previously due to be deprecated in the third quarter of 2024. As we announced in the v17.0 changelog, the Offline Conversions API no longer supports offline events. Graph API v16.0 is the last version that supports offline events. The Offline Conversions API will be discontinued when v16.0 expires in May 2025.
Between now and May 2025, we will be deprecating the remaining Offline Conversions API endpoints on Marketing API v20.0.
The following endpoints are affected:
POST/GET/DELETE /{offline_event_set_id}POST/GET /{offline_event_set_id}/uploadsPOST /{offline_event_set_id}/validatePOST /{offline_event_set_id}/ad_accountGET /{offline_event_set_id}/statsGET /{offline_event_set_id}/shared_agenciesPOST/GET /{offline_event_set_id}/agenciesGET /{offline_event_set_id}/adaccountsGET /{offline_event_set_id}/customconversionsGET /{offline_event_set_id}/audiencesGET /{offline_event_set_id}/shared_accountsGET /{ad_account_id}/offline_conversion_data_setsPOST/GET /{business_id}/offline_conversion_data_setsPOST/GET/DELETE /{business_asset_group_id}/contained_offline_conversion_data_sets
In February 2023, we announced that the Conversions API now fully supports offline events. We recommend that advertisers use the Conversions API for new integrations. We recommend that advertisers with Offline Conversions API integrations convert their integration into a Conversions API integration before May 2025 and not update their Offline Conversions API until they have successfully done so. Learn more about the Conversions API.
Reservation
Campaign Optimization of Impressions
Applies to v20.0+. Will apply to all versions August 19, 2024.
The optimization_goal parameter will no longer accept the impressions value. Any campaigns of this type that are still running will be disabled beginning August 19, 2024.
The following endpoints are affected:
Frequency Controls
Applies to v20.0+. Will apply to all versions August 19, 2024.
The frequency_control_specs parameter should no longer be sent in an API call if the optimization_goal is set to Ad Recall Lift, Link Click Optimization, Post Engagement, or 2-second Video Views. Any campaigns of this type that are still running will be disabled beginning August 19, 2024.
The following endpoints are affected: