Back to News for Developers

Introducing Graph v8.0 and Marketing API v8.0

Today, we’re releasing Graph API v8.0 and Marketing API v8.0. Some updates may require developer action, while others are shared with the purpose of keeping you informed. In this update, we’re also sharing upcoming deprecations. Visit the Platform Initiatives Hub to stay informed of other planned improvements.

If you are an iOS developer, stay tuned for further SDK announcements regarding Apple’s pending iOS14 launch.

Developer Action Required

Changes to tokenless access for User Picture and FB/IG OEmbed endpoints: By October 24, 2020, developers must leverage a user, app, or client token when querying Graph API for user profile pictures via UID, FB OEmbeds and IG OEmbeds. Developers should provide a user or app token when querying for profile pictures via a UID or ASID, though client tokens are supported as well. Please visit our changelog for User Picture, Facebook OEmbed and Instagram OEmbed for details on how to start calling these Graph API endpoints today.

Business Management Permission Updates: For an app to access the business field on ad accounts, we now require the app to have been granted granular permissions to the specific business object being accessed. By November 2, 2020, apps will need to request granular business_management permissions on the business that owns the ad accounts. For more information about granular permissions, check out our permission documentation.

Decoupling catalog_management from ads_management permissions: In response to developer’s interest to access these separately, we are decoupling these permissions. Detailed instructions are included in our v8.0 changelog. By January 31, 2021, developers who already have access to catalog_management will maintain access but will need to prompt their users to grant access via the FB Login Dialog.

Deprecations In This Update

As part of our ongoing commitments to privacy and security, we continue to make updates to our platform, including removing access to a number of APIs, as well as certain features. Timelines for each of these changes are detailed in their corresponding sections of the v8.0 changelog.

API endpoints: A list of API endpoints that will be removed from the platform are listed in the v8.0 Changelog, within their product or node sections. Please review this list to see if your app is impacted.

Sharing for Devices: We will be removing access to the “Sharing for Devices” feature, which allows users to share content from iOT devices to Facebook via a share dialog. Developers will lose access to this feature on November 2, 2020.

Version deprecations:

  • September 28, 2020 - v5.0 and v6.0 of the Marketing API will no longer be available
  • October 27, 2020 - v3.1 of the Graph API will no longer be available

No Action Required, For Your Information Only

The following announcements do not require action today, and rather are meant to keep you informed about other changes on our platform.

App Review Improvements for Business Developers: For developers with business apps, we’re customizing and streamlining app onboarding and integration based on the different ways that developers and businesses use the Facebook platform. We’re also introducing a new reviewable feature called Business Asset User Profile Access for business apps accessing user profile data through business assets. Please read more about this update in our App Review Improvements for Business Developers Blog.

Target Cost Bidding: Starting October 1, 2020, target cost bidding will no longer be available to select from the available bidding options in the UI. Note that target cost will be deprecated in v8.0 of the Marketing API, but accessible in v7.0. For developers who would like to continue controlling cost, we recommend using the cost cap bid strategy, which offers the ability to cap your campaign’s average CPA, and get as many optimization events as you can for your budget without exceeding the cap. Compared to target cost, you can expect more optimization events and more spend when using cost cap.

Action Item Calendar

Marketing API Version Deprecations

  • Be aware that v5.0 and v6.0 of the Marketing API will be removed from the platform. | 09/28/2020 | N/A

Changes to tokenless access for User Picture and FB/IG OEmbed endpoints

  • Update token usage for access to User Picture. | 10/24/2020 | User Picture
  • Update token usage for access to FB OEmbed endpoints. | 10/24/2020 | FB OEmbed
  • Update token usage for access to IG OEmbed endpoints. | 10/24/2020 | IG OEmbed

Graph API Version Deprecation

  • Be aware that v3.1 of the Graph API will be removed from the platform. | 10/27/2020 | N/A

Business Management Permission Updates

  • Apps will need to request granular business_management permissions on the business that own the ad accounts | 11/02/2020 | Permission Documentation

API Endpoints

  • Be aware of upcoming removal of API endpoints from the platform. | 11/02/2020 or 08/04/2022 (specified in the changelog) | Changelog

Sharing for Devices

  • Be aware of upcoming removal of the “Sharing for Devices” feature. | 11/02/2020 | N/A

Decoupling catalog_management from ads_management permissions

  • Developers with access to catalog_management will need to prompt their users to grant access via the FB Login Dialog. | 01/31/2021 | v8.0 changelog