Development

Version 17.0

Updated: May 21, 2024
Copy for LLM
This changelog was updated with the following changes:
  • September 19, 2023: Added User Accounts entry
  • December 19, 2023: Moved Offline Conversions API information from Marketing API to Graph API
  • February 6, 2024: Added affected endpoints for Ad Strategies

Graph API

Released May 23, 2023
Available until September 12, 2025

Instant Articles

As of April 20, 2023, the Instant Articles API no longer returns data. All Instant Articles API endpoints are not available on v17 or later and will be removed for all versions on August 21, 2023.

Offline Conversions API

Deprecation of Offline Conversions API

Applies to v17.0+.
Starting with Graph API v17.0, the Offline Conversions API will no longer support offline events. Graph API v16.0 is the last version that supports offline events. We anticipate that the Offline Conversions API will be discontinued in the third quarter of 2024.
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 the third quarter of 2024 and not update their Offline Conversions API until they have successfully done so. Learn more about the Conversions API.
The following endpoint is affected:

ThreatExchange

The /malware_analyses endpoint is deprecated. It is not available on v17 or later and will be removed for all versions on August 21, 2023.

User Accounts

This entry was added on September 19, 2023.
Applies to v17.0 and later versions. Will apply to all versions on September 15, 2023 (UPDATE: No longer applies to all versions. See September 15, 2023 out-of-cycle change.)
The GET /{user-id}/accounts (aka GET /me/accounts) endpoint no longer returns Facebook pages that have been linked to a Meta business account, unless the app user has granted the business_management permission to the app and has a role on the linked business account.

WhatsApp

Marketing API

Released May 23, 2023
Available until May 14, 2024
Marketing API version auto-upgrade will release on May 14, 2024.

Ads

Existing Posts as Ads

Applies to v17.0+.
Existing photo or video posts from Facebook and Instagram can now be used as ad creatives for ads where the destination is a promoted app. The API calls are the same as for non-app cases, however only posts with call_to_action fields containing valid app store links are supported.
The following endpoints are affected:

Advantage+ Catalog Ads

Applies to v17.0+. Will apply to all versions on August 21, 2023.
Beginning August 21, 2023, you will no longer be able create, edit or use entertainment and media catalogs for campaigns.
The following endpoints, fields, and edges are affected:

Standard Enhancements for Advantage+ Creative

Applies to v17.0+.
The enroll_status parameter for Standard Enhancements is now required for eligible ad creation requests.
The following endpoints are affected:

Campaigns

Ad Strategies

Applies to v17.0+.
Advertisers will no longer be able to query the ad_strategy_id and ad_strategy_group_id fields for their campaigns.
The following endpoints and fields are affected:

Objectives

Applies to v17.0+.
When creating ad campaigns using the Marketing API, only Outcome Driven Ad Experience objectives will be allowed.
The following endpoints are affected: