News for Developers

Back to News

Introducing Graph API v7.0 and Marketing API v7.0

API Updates Provide Developers with Improved App Permissions and Campaign Controls
New Requirements Outlined for Mobile Developers and Facebook App Review

Today, we’re releasing Graph API v7.0 and Marketing API v7.0, along with v7.0 of the Mobile and Business SDKs. Together, these releases capture several timely updates, including new fields developers can use for the Instagram Hashtag Search API and Special Ad Categories and new permissions for page-related data. Additionally, we’re noting some important new requirements for mobile developers.

Lastly, we do have some API deprecations planned, however, we reduced the number in order to help minimize disruptions for our developer community during this challenging time. We have a lot of exciting updates to share with you, let’s dig in:

New Fields for Instagram Hashtag Search API & Special Ad Categories

We’re adding a timestamp field to the Instagram Hashtag Search API which will allow developers to get the creation time for any post accessible via this API. You can learn more about how to access this field in our v7.0 changelog.

We’re also making a minor, but important change to the special_ad_category field — we’re renaming it to special_ad_categories (note the change from singular to plural). Developers can specify a single special ad category (i.e., housing, employment, credit, or none) at the campaign-level. If your campaign does not need a special ad category, you can simply pass in an empty array, or [NONE] as the value.

New Permissions for Apps to Read/Write Page Data

We’re announcing six new permissions to replace manage_pages and publish_pages, all of which are outlined in our v7.0 changelog. Taken together, these new permissions will provide developers with more access and better control over page-related data. Availability of these new permissions will be released on a rolling basis, starting today through June 1, 2020.

Developers that already have access to manage_pages and publish_pages will be automatically migrated to the relevant, new permissions by June 1, 2020, and access will remain undisrupted.

Developers with no existing access to manage_pages or publish_pages should actively monitor their app dashboard for the new permissions as they begin rolling out today. By June 1, 2020, all developers will see the new permissions and are encouraged to apply. After this date, applications for manage_pages and publish_pages will be unavailable and no longer reviewed.

Finally, developers who have recently applied for access to manage_pages and publish_pages will continue to be reviewed, and if approved, will be automatically migrated to the relevant, new permissions.

New Deadlines & Requirements for Mobile Developers

If you’re an iOS developer, it’s important to point out Apple’s recent announcement, which states apps for iPhone or iPad must be built with the iOS 13 SDK or later and use Xcode 11 or later. The deadline for adhering to these new iOS requirements is June 30, 2020.

And if you’re an Android developer, note that Android SDK will now be using the Android X libraries. All apps leveraging the Facebook SDK v7.0 must migrate to Android X for continued use.

Important API Deprecations

As part of our ongoing commitment to privacy and security, we are removing access to a number of APIs. However, as a means of minimizing disruption for our developers in the current COVID-19 climate, we significantly reduced the number of APIs we are removing access to.

A list of endpoints that will be removed from the platform are listed in the v7.0 changelog, within their product or node sections. You should review this list to see if your app is impacted.

Also, please be aware of the upcoming version deprecations:

  • 7/26/2020 - Graph API v3.0 will no longer be available.

As always, if you find a bug with the API, please report it to Facebook Developer Support. And if you have specific questions or concerns, please consider joining the Facebook Developer Community — it’s a tremendously helpful resource for communicating and connecting with Facebook developers all over the world.