Version 8.0

Graph API

Released Tuesday, Aug 4, 2020 | Available until TBD | Blog post


Access Tokens

Deprecated Endpoints

Deprecated in v8.0+. Will be deprecated in all versions Nov 2, 2020.


Albums

Reinstated Endpoints

Applies to all versions.


App Configuration

App Types

This change applies to all versions.

Newly created apps can now choose an App Type: Business, Gaming, or None. This simplifies the App Review interface by removing inappropriate Permissions and Features based on the chosen type. In addition, apps typed as Business apps use a new authorization mechanism, no longer use modes, and have access to a new Feature. Refer to the Business apps changelog entry for details.


Business Apps

Apps typed as Business apps use a new authorization mechanism called Access Levels. Access Levels replace the functionality provided by Development Mode and Live Mode, which have been removed for Business apps, and make the App Review process simpler and more intuitive. In addition, a new Business Asset User Profile Access Feature has been released, which allows Business apps to read a small set of public User fields. These changes are described in more detail below.

Access Levels

Applies to all versions.

Access Levels are a new Graph API authorization mechanism for Business apps that apply to Permissions and Features on an individual basis. Standard Access only allows access to data owned by users who have a Role on the app, or a Role in a Business that has claimed the app. Advanced Access allows access to data owned by any app user, but requires App Review. Business apps are auto-granted Standard Access for all Permissions and Features available to their type.

Development and Live Mode Removal

Applies to all versions.

Development Mode and Live Mode have been removed for apps typed as Business apps. These modes have been replaced by Access Levels, which provide the same functionality and more versatility — since Business apps have Standard Access for all available Permissions and Features, any user with a Role on the app, or a Role in a Business that has claimed the app, can grant the app any available Permission at any time. This eliminates the need for App Review or having to switch between modes during development.

New Business Asset User Profile Access Feature

Applies to all versions.

The new Business Asset User Profile Access Feature allows Business apps to read a small set of public Fields on a User, as long as the User has engaged with assets owned by a Business that has claimed the app. Refer to the Business Asset User Profile Access reference for a list of readable User Fields.


Comments

Reinstated Endpoints

Applies to all versions.


Devices

Deprecated Endpoints

Deprecated in v8.0+. Will be deprecated in all versions Nov 2, 2020.


Groups

Deprecated Endpoints

Deprecated in v8.0+.

  • GET /{group-id}/posts

Deprecated in v8.0+. Will be deprecated in all versions Nov 2, 2020.


Instagram

New Instagram oEmbed Endpoint

Applies to all versions.

A new GET /instagram_oembed endpoint has been introduced. It provides the same functionality as Instagram's Legacy oEmbed endpoints, which will be deprecated on Oct 24, 2020. The new endpoint requires an access token, so you will need a Facebook Developer account and registered app to access it. Refer to the Instagram oEmbed document for usage instructions and additional details.


Life Events

Deprecated Endpoints

Deprecated in v8.0+.


Links

Deprecated Endpoints

Deprecated in v8.0+.


Live Videos

Deprecated Endpoints

Deprecated in v8.0+.

Use the GET /{live-video-id}/reactions endpoint to get likes for a LiveVideo.

save_vod Parameter

Applies to v8.0+. Will apply to all versions on Nov 2, 2020.

The save_vod parameter is deprecated for the following edges:


Messenger Platform

Deprecated Endpoints

Deprecated in v8.0+.

App Review

Applies to all versions.

App Review for Messenger has been moved from Products > Messenger > Settings to App Review in the app dashboard. To request Messenger specific permissions, pages_messaging, pages_user_gender, pages_user_locale, and pages_user_timezone, go to App Review > Permissions and Features. See the Messenger App Review documentation for more details.

Messenger Profile Edge

Applies to v8.0+.

The nested persistant menu type has been deprecated for POST /{page-id}/messenger_profile.

New Feature: Messenger for Shops

Applies to v8.0+.

Support for sending and receiving products on Messenger for Shops. This includes the Product Template that can be used to send products in messages, Webhooks for messages with product template and messages from Facebook Shops Product Detail Page, and echo Webhooks for messages with products.


Native Offers

Deprecated Endpoints

Deprecated in v8.0+.


Open Graph

Deprecated Endpoints

Deprecated in v8.0+. Will be deprecated in all versions on Nov 2, 2020.

  • GET /{open-graph-action-id}/comments
  • POST /{open-graph-action-id}/comments

Pages

Deprecated Endpoints

Deprecated in v8.0+.

Page Post

Deprecated in all versions.

The Page Post comment ID format, {page-id}_{post_id}_{comment-id}, has been deprecated. Use the {pagepost-id}_{comment-id} format instead.


Photos

Deprecated Endpoints

Deprecated in all versions.


Places

Deprecated Endpoints

Deprecated in v8.0+.


Posts

Deprecated Endpoints

Deprecated in v8.0+. Will be deprecated in all versions on Nov 2, 2020.

Use the GET /post/reactions endpoint to get likes for a post.


Search

Deprecated Endpoints

Deprecated in v8.0+. Will be deprecated in all versions Nov 2, 2020.


Security Settings

Deprecated Fields

Deprecated in v8.0+. Will be deprecated in all versions on Nov, 2020.


Social Plugins

Facebook oEmbed Endpoints

This change will apply to all versions on October 24, 2020.

Facebook oEmbed Endpoints, which allow apps to get embed HTML for public Facebook posts and videos, will be deprecated on October 24, 2020. Three new endpoints have been introduced which provide the same functionality as the old endpoints they are replacing:

The new endpoints require an Access Token and requests will be subject to rate limiting. Please refer to the new oEmebd endpoint documenation for usage details and additional information.


Users

Deprecated Endpoints

Deprecated in v8.0+.

Deprecated Fields

Deprecated in v8.0+. Will be deprecated in all versions on Nov, 2020.

Deprecated in all versions.

Reauthorization

This change applies to all versions.

Starting Oct 24, 2020, the following fields will require Data Access Reauthorization after 90 days of inactivity:

User Picture

Applies to all versions on Oct 24, 2020.

Starting October 24, 2020, the GET /{user-id}/picture endpoint (GET /{user-id}?fields=picture) will require an App-Scoped User ID (ASID) for tokenless requests. If you query the User with a non-ASID, you must include an App, Client, or User Access Token in the request. Refer to the User Picture reference for details.


Video Questions

Deprecated Endpoints

Deprecated in v8.0+.


Workplace

Deprecated Endpoints

Deprecated in v8.0+. Will be deprecated in all versions on Nov 2, 2020.

Marketing API

Released Tuesday, August 4, 2020 | Available until TBD | Blog post


Ad Accounts

Deprecated Endpoints

Deprecated in v8.0+.

Permissions

Applies to v8.0+. Will apply to all versions on Nov 2, 2020.

Apps need granular permissions to access the business fields of an Ad Account. Permissions should be granted for a specific Business object.


Asset Customization Rules

Validation

Applies to v8.0+.

All ads using asset_feed_spec must contain at least two target customization rules. If your creative uses asset_feed_spec and includes less than two rules, you will not be able to create that ad.

This change affects Placement Asset Customization, Multi-Language Ads, and Segment Asset Customization.

Segment Asset Customization

Applies to v8.0+. Will apply to all versions on Nov 2, 2020.

All use cases unrelated to geolocation have been deprecated for Segment Asset Customization users. With this change, all targeting rules must contain geolocation information inside their customization spec. There is an exception for the default rule, which does not need to include geolocation.


Bidding

Target Cost Bid Strategy

Applies to v8.0+

The TARGET_COST bid strategy is deprecated. To continue controlling cost, we recommend using cost cap bidding. See all available bid strategies.


Business Manager

Deprecated Endpoints

Deprecated in v8.0+.

Reintroduced Sharing Agreements Endpoints

Applies to all versions

The following endpoints have been reintroduced:

Both endpoints had previously been deprecated with the launch of Graph API V6.0.


Catalog API

Permissions

Applies to v8.0+. Will apply to all versions on January 31, 2021.

You no longer need the ads_management permission to access product catalog endpoints. Moving forward, you will need the catalog_management permission to call those endpoints. Developers who have had access to catalog endpoints via ads_management in the last 90 days will be automatically migrated to catalog_management permissions by August 14, 2020.

From now until January 31, 2021, developers using prior versions of the API are still able to call product catalog endpoints with the ads_management permission. If you are using v8.0, you must have catalog_management permission.

After the January deadline, the catalog_management permission will no longer be associated with ads_management, so users will have to explicitly grant catalog_management permission for your app.

Authentication

Applies to v8.0+. Will apply to all versions on Nov 2, 2020.

[UPDATED] The following Catalog API endpoints now respect two-factor authentication Business settings. Any app calling this endpoint will receive an error if the Business that owns the catalog requires two-factor authentication for the current app user and the app user has not authenticated via two-factor.

When the current app user has access to the catalog through a partner business, we respect the authentication requirements from the partner’s Business Manager.


Reporting

Deprecations

Applies to v8.0+

  • GET /{ad-study-id}?fields=split_test_config
  • GET /{ad-study-id}?fields=iterative_split_test_config

Targeting

Deprecation

Applies to v8.0+

  • GET /search?type=adzipcode

Corrections

On September 28, we updated the Catalog API authentication entry for clarity.