Back to News for Developers

Introducing Facebook Graph API v17.0 and Marketing API v17.0

May 23, 2023ByAyyad Farah

Today, we are releasing Facebook Graph API v17.0 and Marketing API v17.0. As part of this release, we are highlighting changes below that we believe are relevant to parts of our developer community. These changes include announcements, product updates, and notifications on deprecations that we believe are relevant to your application(s)’ integration with our platform.

For a complete list of all changes and their details, please visit our changelog.

Deprecations & Breaking Changes

Deprecate Ad Strategies

The Ad Strategies beta product has been deprecated since October 28, 2022. Because of this, we are deprecating the fields ad_strategy_id and ad_strategy_group_id on the campaigns endpoint with the release of Marketing API v17.0.

Deprecation of Offline Conversions API

Since February 2023, the Conversions API fully supports offline events, ensuring parity features provided by the current Offline Conversions API endpoint. By consolidating our web and offline event APIs into a single API, we hope to simplify and improve how advertisers use their cross-channel marketing data to enhance ad optimization, custom audiences, and measurement.

Starting with Graph API version 17 onwards, released on May 23, 2023, Offline Conversions API will no longer support offline events. We recommend that advertisers with Offline Conversions API integrations convert their integration into a Conversions API integration and not update their Offline Conversions API until they have successfully done so.

Deprecate Legacy objective creation

As announced in December 2021, we redesigned the objective selection experience when creating new campaigns to effectively guide advertisers to campaign setups that help to better achieve their marketing goals. The new experience, Outcome-Driven Ad Experiences, resulted in changes to the Marketing API.

We will begin the process of deprecating the legacy experience and objectives, starting with the release of Marketing API v17.0. When using Marketing API v17.0, campaigns can only be created with Outcome-Driven Ad Experience objectives, and the legacy objectives' APIs will be deprecated. Existing legacy campaigns and duplication of existing legacy campaigns will still be supported and not be impacted in this version. More details can be found in our recent developer blog post.

Advantage+ creative standard enhancements field required

Earlier this year, we released Advantage+ creative standard enhancements on Marketing API. Beginning on May 23, 2023, Marketing API users will be required to specify an ad's enrollment to Advantage+ creative's standard enhancements by providing 'OPT_IN' or 'OPT_OUT' in the 'enroll_status' field. If the field is left blank, the user will receive an error and be directed to complete the field. To learn more about Advantage+ creative standard enhancements on Marketing API, please view this developer blog post.

The following endpoints are affected

  • POST /{ad-account-id}/adcreatives
  • POST /{ad-account-id}/ads

Deprecate Advantage+ Catalog Ads for Streaming

With Marketing API v17 release, we are deprecating Advantage+ Catalog Ads for Streaming (A+CA for Streaming) catalog usage. Commerce Catalog ads is the recommended alternative to A+CA for Streaming. Here is a guide for setting up a Commerce Catalog. The below endpoints will be deprecated:

  • Create a A+CA for Streaming catalog: Edge owned_product_catalogs with vertical media_titles
  • Upload Media Title Feeds: Edge product_feeds for a A+CA for Streaming catalog
  • Create a Media Title Item: Edge media_titles for a A+CA for Streaming catalog
  • Create a campaign using a A+CA for Streaming catalog: Edge campaigns with a DAS catalog either on L3, L2, or L1

On August 21, 2023, the above changes will apply to all Marketing API versions, and we will be pausing all campaigns that have A+CA for Streaming catalogs attached at the L3, L2, or L1 level.

Deprecate Instant Articles API

As the Instant Articles product was deprecated on April 20th 2023, an API that allows publishers to manage their instant articles will be deprecated now.

Enforcing Business Management Permission on User Accounts

Earlier, additional business admined pages were returned without the business_management permission access. Beginning on May 23, 2023, if you would like to continue receiving access to the business admined pages, the business_management permission will be required. You can refer to the business_management page for more details related to this permission.

API Version Deprecations:

As part of Facebook’s versioning schedule for Graph API and Marketing API, please note the upcoming deprecations:

Graph API

  • June 8, 2023: Graph API v10.0 will be deprecated and removed from the platform
  • September 14, 2023: Graph API v11.0 will be deprecated and removed from the platform
  • February 8, 2024: Graph API v12.0 will be deprecated and removed from the platform

Marketing API

  • August 15, 2023: Marketing API v14.0 will be deprecated and removed from the platform
  • August 15, 2023: Marketing API v15.0 will be deprecated and removed from the platform

To avoid disruption to your business, we recommend migrating all calls to the latest API version that launched today.

Facebook Platform SDK

As part of our 2-year deprecation schedule for Platform SDKs, please note the upcoming deprecations and sunsets:

  • June 2023: Facebook Platform SDK v9.0 or below will be sunset
  • October 2023: Facebook Platform SDK v11.0 or below will be sunset
  • February 2024: Facebook Platform SDK v12.0 or below will be sunset