Back to News for Developers

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

June 8, 2021ByKirk Thaker

Today, we are releasing Facebook Graph API v11.0 and Marketing API v11.0. As a part of this release, we have created this blog post to highlight broad-reaching changes that will impact parts of our developer community. These changes include announcements and product updates, reminders from prior launches, and notifications on large-scale deprecations that may affect your application(s)’ integration with our platform.

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

General Announcements and Updates

Expanding Graph API Access Levels Model to Consumer Applications

On May 6, 2021, Facebook began expanding the data access level functionality introduced in Graph API v8.0 to Consumer apps. This rollout will complete in late June / early July. This model makes testing new permissions and features easier, since anyone with a role on the app can grant it any unapproved permission or feature without having to switch to Development mode or having to use a test app.

This functionality will launch for all newly created Consumer apps in the coming weeks. Note that as part of this change, new Consumer apps must be set to Live Mode and the public_profile permission set to Advanced Access before users who do not have a role on the apps can authenticate using Facebook Login. The public_profile and email permissions are automatically approved for Advanced Access but are set to Standard Access by default.

Please refer to our access levels developer documentation to learn more about how access levels affect Consumer apps.

Addition of Instagram ASIDs and Platform Versioning

Starting June 8, 2021, the Instagram Basic Display API will now support versioning. You may now perform versioned calls on all 'graph.instagram.com' endpoints using the same versioned request protocol as the Facebook Graph API.

Also, as part of this release, Instagram introduces app-scoped IDs (ASIDs), which are user IDs unique to each app and user pair.

New oEmbed Read Feature and App Review

Starting June 8, 2021, the oEmbed product has been replaced with a new oEmbed Read feature. Developers who have implemented Facebook oEmbed or Instagram oEmbed must be approved by App Review for the new oEmbed Read feature by September 7, 2021 or their oEmbed integrations will be revoked. New apps that require access may submit for review during app creation or any time after.

Audience Deletion

Changes to the Audience Deletion API

As part of Facebook’s ongoing effort to improve how advertisers create and manage their audiences, Custom Audiences (except Customer List Custom Audiences), Lookalike Audiences, or saved audiences that have not been used in active ad sets for over two years will be automatically deleted.

For Customer List Custom Audiences, Facebook will continue to store and delete these in accordance with advertisers’ instructions. If an advertiser chooses not to use an audience tagged as an “Expiring Audience” within the allotted time frame, Facebook will treat this as an instruction to delete the audience.

Additionally, moving forward, any Custom Audience (except Customer List Custom Audiences), Lookalike Audience, or saved audience which has not been used in an active ad set for over two years will automatically be tagged as an “Expiring Audience” and will be auto-deleted 90 days after being identified as an expiring audience.

This change will be rolled out:

  • Starting June 08, 2021, for advertisers using the Marketing API (including those advertisers who use both the Marketing API and Facebook UI for ads management) and will impact all existing API versions. Auto-deletion of impacted audiences will occur on September 6, 2021 unless advertisers take action to use the flagged audiences.
  • Began May 13, 2021, for advertisers NOT using the Marketing API for ads management. Auto-deletion of impacted audiences will occur on June 27, 2021 unless advertisers take action to use the flagged audiences.

Deleted Facebook Page Based Audience Deletion

As part of our ongoing effort to improve how advertisers create and manage their audiences, we are making an update that affects Engagement Custom Audiences, associated Lookalike Audiences and saved audiences created from a deleted Facebook page. We expect impact for most advertisers to be minimal.

Starting September 08, 2021, for advertisers using the Marketing API: Engagement Custom Audiences (page, video, lead form, event, instant experience, shopping), associated Lookalike Audiences, and saved audiences that were created using a deleted Facebook page will be marked with a “warning status” with a 30 day grace period before being automatically deleted. New campaigns can continue to be created and scheduled up until this cut-off date.

Additionally, moving forward, after September 8, 2021 advertisers will not be able to create these Engagement Custom Audiences types or Lookalike Audiences from deleted Facebook pages.

Release of Facebook Platform SDKs v11.0

Starting June 08, 2021, Facebook is releasing Platform SDKs v11.0. With this release, we are deprecating v9.0 and introducing several feature updates. Please visit the iOS SDK Changelog, Android SDK Changelog and Unity SDK Changelog to learn about important upcoming changes to these SDKs. Additionally, Facebook has posted a separate blog highlighting these updates.

Endpoint Specific Announcements and Updates

Specifying Permissible Use Cases for user_likes and user_posts

Starting June 8, 2021, in an effort to reduce risk on our platform, we are further specifying the permissible use cases for both user_likes and user_posts. If your app currently has access to user_likes and/or user_posts, and your use case is not aligned with the updated permissible use case(s), you will have until September 6, 2021 to make any necessary changes on your app, to account for it no longer being eligible to access one or more of these permissions. Beginning September 6, 2021, apps with access to these permissions that don’t fall under the new permissible use cases will be subject to enforcement action.

If you're unsure whether your use case aligns with these updates, please proactively submit for App Review before September 6, 2021. Apps' whose use case does align with the updated permissible use case(s) will not be impacted by this change.

Product Group and Catalog Endpoint Modifications

Starting June 8, 2021, for API v11.0+, Facebook is implementing several changes to how you engage with product group and catalog:

  • Default Product Group Deletion will no longer allow deletion of non-empty product groups by default. Non-empty product groups can be deleted by applying deletion_method=delete_items to the deletion request. This will delete both the product group and its items.
  • Change to Default Catalog Deletion will not support the deletion of a product catalog by default if it has live product sets. A live product set is classified as being actively used (e.g., ads campaigns, promotions, and published Shops).
  • Addition of Catalog Diagnostics Endpoint utilized to retrieve diagnostics data for a given product catalog. This endpoint could help identify issues like products not showing in channels or displaying opportunities that could improve product discoverability.

Change to Inventory Field

Starting on June 8, 2021, for API v11.0+, to eliminate inconsistencies between surfaces and remove confusion around availability and inventory, Facebook will add the quantity_to_sell_on_facebook field as a replacement for the inventory field.

The quantity displayed by this new field will not be reduced by reserved inventory, defined as inventory temporarily reserved when buyers add an item to their cart. We will continue to support the ‘inventory’ field for the near term. However, we recommend that you use the new ‘quantity_to_sell_on_facebook’ field instead.

Reminder No Action Required

New Pages Experience

On October 2, 2020, Facebook announced the new Page experience as a way for public figures, businesses and others who want to build and connect with an audience to manage their professional presence on Facebook. All classic Pages are currently being transitioned over to the new Pages experience in a gradual rollout. We are planning to complete the rollout within the next few months, and classic Pages will eventually be deprecated.

Please see the developer documents to learn how to determine whether a Page has been transitioned yet and visit the Help Center for questions.

Platform Live Status Feature Update

On June 1, 2021, Facebook launched a new Platform Live Status page to increase transparency and proactive communication with external developers using Facebook platform products. This new Facebook for Business Status page will serve as the single location for checking server health for platform and business products offered by Facebook, including Ads, WhatsApp Business API, Facebook Developer Platform, and more.

Deprecations

Facebook Analytics Deprecation

Originally announced March 30, 2021, Facebook is in the process of deprecating Facebook Analytics (FBA). After June 30, 2021, the Facebook Analytics tool will no longer be available. Additionally, we are deprecating the Dashboard Plugin for Marketing API.

While the individual Facebook Analytics tool is going away, these alternatives are still available:

  • Events Manager
  • Ads Manager
  • Page Insights
  • Instagram Insights
  • Facebook Business Suite Insights

Messenger Platform - Airline Templates Deprecation

Starting June 8, 2021, Graph API v11.0+ will no longer support businesses' abilities to send Airline Templates. Deprecation for the prior Graph API versions (v10.0 and below) will occur 6 months after the announcement of this change on December 6th, 2021.

We recommend businesses send boarding passes and check-in templates as images, consistent with how companies typically send these notifications in other channels.

Native Offers Endpoint Deprecation

Starting June 8, 2021, if you are using Offer Ads API, you are encouraged to use Facebook Ads instead, for building your promotions and discounts. Offer Ads API endpoints will be deprecated upon the release of Graph and Marketing API v12.0 in the fall. Though we are not officially deprecating the endpoint on the launch of v11.0, we will begin transitioning support that may cause a sub-optimal experience if you continue to use this endpoint.

Page Public Content Access - Comments Node Deprecation

Starting June 8, 2021, for Graph API v11.0+, the “id” field for all comments returned in requests using the Page Public Content Access feature will be removed. Note: nested requests will still be supported for these objects.

This change will apply to all other active API versions (v10.0 and below) on September 6, 2021.

Page Public Content Access - Comments Node Deprecation

Starting June 8, 2021, access to the following endpoints is temporarily limited to apps that have queried them within the last 30 days:

  • gr:post:Business/client_adaccounts
  • gr:post:AdAccount/agencies
  • gr:post:BusinessRequest

API Version Deprecations:

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

  • August 3, 2021: Graph API v3.3 will be deprecated and removed from the platform
  • August 25, 2021 Marketing API v9.0 will be deprecated and removed from the platform
  • October 4, 2021: Marketing API v10.0 will be deprecated and removed from the platform
  • November 2, 2021: Graph API v4.0 will be deprecated and removed from the platform
  • February 3, 2022: Graph API v5.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.

Action Item Calendar

General Announcements and Updates

  • May 12, 2021: Changes to Audience Reaping UI (Advertisers NOT using Marketing API)
  • Rolling:
    • Expanding Graph API Access Levels to Consumer Applications with planned completion in late June / early July
  • June 8, 2021:
    • Addition of Instagram ASIDs and Platform Versioning
    • Addition of oEmbed Reviewable Feature in App Review
    • Changes to the Audience Reaping API
    • Release of Facebook Platform SDKs v11.0
  • November 2, 2021: Data Deletion Requests Deadline

Endpoint Specific Announcements and Updates

  • June 8, 2021:
    • Further specification on Permissible Use Cases for user_likes and user_posts
    • Launch of Product Group and Catalog Endpoint Modifications
      • Default Product Group Deletion will no longer allow deletion of non-empty product groups by default
      • Change to Default Catalog Deletion will not support the deletion of a product catalog by default if it has live product sets
      • Addition of Catalog Diagnostics Endpoint utilized to retrieve diagnostics data for a given catalog
    • Replacement of ‘Inventory Field’ with ‘quantity_to_sell_on_facebook’ field for API v11.0+
  • November 10, 2022: Data Deletion Requests Deadline

Reminders, No Action Required

  • Rolling:
    • Began October 2, 2020: New Pages Experience announced as a way for public figures, businesses and others who want to build and connect with an audience to manage their professional presence on Facebook.
  • June 1, 2021: Launch of Platform Live Status Feature Update

General Deprecations

  • June 8, 2021:
    • Facebook Platform SDKs v11.0 will be deprecated and removed from the platform
    • Messenger Platform - Airline Templates will be deprecated and removed from the platform for v11.0+
    • Page Public Content Access - Comments Node will be deprecated and removed from the platform for v11.0+
    • Temporary Business Endpoint Restrictions go into effect
  • June 30, 2021: Facebook Analytics will be deprecated and removed from the platform
  • September 6, 2021: Page Public Content Access - Comments Node will be deprecated and removed from the platform for v10.0 and below
  • June 8, 2021: Native Offers Endpoint Deprecation
  • Fall 2021: Native Offers Endpoint Deprecation
  • December 6, 2021: Messenger Platform - Airline Templates will be deprecated and removed from the platform for v10.0 and below

Marketing API Version Deprecations:

As part of our Marketing API versioning schedule, please note the upcoming Marketing API version deprecations:

  • August 25, 2021: Marketing API v9.0 will be deprecated and removed from the platform
  • October 4, 2021: Marketing API v10.0 will be deprecated and removed from the platform

To avoid disruption to your business, we recommend migrating all calls to the latest Marketing API version that launched today. (Visit the changelog for more details).

Graph API Version Deprecations:

As part of our Graph API versioning schedule , please note the upcoming Graph API version deprecations listed below:

  • August 3, 2021: Graph API v3.3 will be deprecated and removed from the platform
  • November 2, 2021: Graph API v4.0 will be deprecated and removed from the platform
  • February 3, 2022: Graph API v5.0 will be deprecated and removed from the platform