Version 10.0
Graph API
Released Tuesday, February 23, 2021 | Available until TBD | Blog post
Business Apps
Access Levels
Applies to all apps created after February 16, 2021.
All Business type apps created after February 16, 2021 will automatically be granted Standard access to the email and public_profile permissions.
Applies to all existing apps created after February 16, 2021.
All Business type apps created before February 16, 2021 will automatically be granted Advanced access to the email and public_profile permissions. Apps that are not using the email or public_profile permissions will be downgraded to Standard access for these two permissions.
Business type apps can upgrade to Advanced access for the email and public_profile permissions without going through App Review.
Groups
Applies to v10.0+. Will apply to all versions on May 25, 2021.
- To align with other Facebook data retention policies, the Groups API will only include data created within the last 90 days of your queries. The data returned is dependent on the access level or mode of your app and your role on the app.
- Groups API will now use a 2 tiered API access level system, Standard level and Privileged level, instead of Dev mode and Live mode access. Standard level access will only allow you to get data for users that have a role on your app, while Privileged level access will allow you to get data from all users in the group that the app is installed in.
Pages
Reinstated endpoint
Applies to v10.0+. Will apply to all versions on May 25, 2021.
The DELETE /{page-id}/tabs endpoint that was deprecated in v8.0 has been reinstated in v10.0 and will be reinstated in all versions on May 25, 2021.
Threat Exchange
Deletion of expired data
Will apply to all versions on May 25, 2021.
Data uploaded to ThreatExchange with a non-zero expire_time will be permanently deleted at the expiration time indicated. If you wish to delete data that is no longer valid, set the expired_on field to the current time to have the data deleted immediately.
Additionally, all non-Facebook ThreatDescriptors will be permanently deleted once they reach the expiration date set by the creator. If your application currently has expired ThreatDescriptors that you don’t want deleted, you must extend the expiration date or set it to ‘0’ to ensure that the data never expires.
URL
Applies to v10.0+. Will apply to all versions on May 25, 2021.
Engagement
- Due to privacy concerns, counts returned by a
GET /?id={url}/engagementrequest may not match raw counts. - Requests for the
GET /?id={url}/engagementfield for the same URL will be limited to 10 requests per hour.
Marketing API
Released Tuesday, February 23, 2021 | Available until TBD | Blog post
Ad Account
Adsets
Applies to v10+. Will apply to all versions May 25, 2021.
The following endpoints will no longer accept connections targeting when creating or editing ad campaigns:
This change will not affect any existing running campaigns.
Field changes
Applies to v10.0+. Will apply to all versions May 25, 2021.
The agency_client_declaration field on the AdAccount node now requires Admin privileges for all operations.
Ads Insights API
Updated date_preset parameter
Applies to v10.0+.
- The
lifetimeparameter (date_preset=lifetime) is disabled and replaced withdate_preset=maximum, which can be used to retrieve a maximum of 37 months of data. The API will return an error when requests contain date ranges beyond the 37-month window. - For v9.0 and lower, there will be no change in functionality until May 25, 2021. At that time,
date_preset=maximumwill be enabled and anylifetimecalls will default tomaximumand return only 37 months of data.
Business
Easing of Previous Endpoint Access Restrictions
Applies to 10+.
In v9.0, access to the endpoints below was restricted. Access has been restored to all apps, but apps can now only target businesses (or child businesses of those businesses) that have claimed them: