Facebook Business Extension (FBE) allows your sellers to easily run ads across the Facebook family of apps by connecting existing Facebook assets such as a Facebook Page or Business Manager or by creating entirely new assets. FBE can be used to help seamlessly onboard marketplace sellers to Meta solutions.
Below are the key steps specific to the marketplace flow. We recommend that you use these steps in tandem with the main developer docs.
Private permission
manage_business_extension
— This is a private permission that requires your Meta representative to add your app to the allow list. Reach out to your Meta representative for assistance. Public permissions (marketplace needs to request these through App Review).
business_management
— required to get back Business Manager ID created through FBE and to use Business Manager API to manage business assets.ads_management
— required to manage sellers’ ads on behalf of the client.Field | Description |
---|---|
Type: setup | Required. Seller’s Facebook setup, such as their unique identifier ( |
Type: business_config | Required. Configuration object that the Meta Business Extension uses to configure the Meta Business Extension workflow. See |
Type: boolean | Required. Set this value to |
Field | Description |
---|---|
| Required. |
| Required. |
| Required. |
| Required. |
| Optional. |
| Required. Note: The |
| Optional. |
| Optional. |
Use this object to configure the business settings for an end user; this includes Messenger and more. Each field includes a "type" linked to the respective tables below.
Field | Description |
---|---|
| Required. |
| Optional. |
| Optional. |
| Optional. |
| Optional. |
| Optional. |
Launch the FBE Management View after the FBE set up is completed and the asset IDs are successfully returned through Webhooks / APIs.