Version 20.0

Marketing API

May 21, 2024 | Available until May 6, 2025 | Blog post

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:

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:

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.

Messaging Ads

Sponsored Messages

Applies to v20.0+. Will apply to all versions August 19, 2024.

Creation of the sponsored messages ad type will no longer be available. This change will not affect other messaging ads ad types.

The following endpoints are affected:

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: