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.See the WhatsApp Business Platform changelog.
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:
POST /{ad-account-id}/campaignsPOST /{ad-account-id}/adsetsPOST /{ad-account-id}/adsPOST /{business-id}/owned_product_catalogs?vertical=media_titlesPOST /{product-catalog-id}/product_feeds?feed_type="media_title"POST /{product-catalog-id}/media_titles
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:
GET/{ad-account-id}/campaigns?fields=ad_strategy_idGET/{ad-account-id}/campaigns?fields=ad_strategy_group_idGET /{campaign-id}?fields=ad_strategy_group_idGET /{campaign-id}?fields=ad_strategy_id
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: