Meta Business Extension

Meta Business Extension API Changelog

How the Changelog Works

  • Use this Meta Business Extension API changelog as a repository of versioned changes to the Graph API and Marketing API, and any products or services that rely on them.
  • You can use the API Upgrade Tool to determine which version changes will affect your API calls.
  • This changelog only contains changes specific to Meta Business Extension APIs and integrations. To see the full Marketing API changelog and latest version, see Changelog, Graph API and Marketing API.
  • Breaking changes do not affect all API versions. We only introduce breaking changes in the next Graph API version, unless the change is a major privacy or security fix (rare). Non-breaking changes affect all API versions immediately. Learn more about breaking changes.

Version 8.0

September, 2020

  • The following options have been added to the channel field: FEED, SIGNALS, and COMMERCE_OFFSITE. The option IG_SHOPPING has been removed from the same field. See setup, Reference.
  • FBE Install API calls now return the field commerce_account_id. See FBE Installation API.
  • The domain field is now required for COMMERCE and COMMERCE_OFFSITE channels. See setup, Reference.
  • You can now specify the selected tab for FBE Management View by passing tab. See FBE Feature Management View.
  • Partners should request the instagram_basic scope for all commerce flows (COMMERCE and COMMERCE_OFFSITE).
  • We have created a new guide for developers looking to launch FBE, v2 on mobile.
  • You can now uninstall FBE by making a DELETE request to the following endpoint: 
curl -X DELETE \
"https://graph.facebook.com/v<API_VERSION>/fbe_business/fbe_installs?fbe_external_business_id=<FBE_EXTERNAL_BUSINESS_ID>&access_token=<ACCESS_TOKEN>"

Version 7.0

July 24th, 2020

These new fields have been added or modified in the Webhook notication and FBE Installation API:

  • Business Manager ID (business_manager_id): Field has been added to Webhook notifications and FBE Installation API. business_management is not required to receive this ID>

June 15, 2020

This change applies to all versions.

These new fields have been added to the Setup object:

  • Business Manager ID (business_manager_id) — Business Manager ID for a user's existing business manager that a partner can pass in to preselect for the user in the setup flow.

  • Ad Account ID (ad_account_id) — Ad Account ID for a user's existing ad account that a partner can pass in to preselect for the user in the setup flow.

  • Page ID (page_id) — Page ID for a user's existing Facebook Page that a partner can pass in to preselect for the user in the setup flow.
  • Instagram Business Profile ID (ig_profile_id) — Instagram Business Profile ID for a user's existing Instagram Business Profile that a partner can pass in to preselect for the user in the setup flow.
  • Pixel ID (pixel_id) — Pixel ID for a user's existing Pixel that a partner can pass in to preselect for the user in the setup flow.
  • Catalog ID (catalog_id) — Catalog ID for the user's existing catalog.

May 27, 2020

This change applies to all versions.

Two new fields have been added to the FBE Install API and Webhook:

  • Pages (pages) — List of Facebook Page IDs. Use these IDs to create separate Graph API requests for other Facebook Page integrations you may have. If the pages field is not included, this means the business has not connected any Facebook Pages with FBE.

  • Instagram Profiles (instagram_profiles) — List of Instagram Business Profile IDs. Use these IDs to create separate Graph API requests for other Facebook or Instagram integrations you may have. If the instagram_profiles field is not included, this means Instagram-related scope (for example, instagram_basic) is not included in the access token and/or the business has not connected any Instagram Business Profile with FBE.

May 5, 2020

This change applies to all versions.

Two new fields have been added to the Facebook Business Extension, v2:

  • Ad Account ID (ad_account_id) — Represents the ad account ID selected by the user inside FBE. This ad account can be used to manage ads if your app has ads_management permissions.

  • Catalog ID (catalog_id) — The catalog ID selected by the user inside FBE. This ID can be used to manage their product catalog.

Learn more about Version 7.0, Changelog.

Learn More