Fresh 2026

FBE Messaging Onboarding

The Facebook Business Extension (FBE) allows businesses to easily set up and manage conversations with their customers at scale on Facebook and Instagram. The FBE Messaging onboarding flow allows businesses to set up or integrate the following:

• Business Manager
• Facebook Page
• Instagram account (if already connected with Facebook Page)
• Ad account
• Messenger chat (optional)

This document outlines the main prerequisites for the FBE Messaging flow along with a high-level overview of the steps required to complete the process. Please refer to the Facebook Business Extension guide for specific details on overall integrations.

Example, Onboarding flow from Facebook surface (Business Apps)

Before You Start

1. Your app must be owned by a Business Manager that is a verified business. Learn more about how to verify your business.

2. A Facebook app is required with the following access level, feature and permissions:

   • Access Level: Advanced Access
   • Feature: Ads Management Standard Access
   • Public Permissions: ads_management, ads_read, business_management, pages_manage_ads, pages_manage_metadata, pages_messaging, pages_show_list, page_events
   • Private Permissions: manage_business_extension, This is a private permission that requires your Facebook representative to add your app to the allow list. Reach out to your Meta representative for assistance.

3. Set up authentication with the required configurations and launch the FBE onboarding flow via Business Login (on partner platform) or Business Apps (on Facebook).

Required Configurations

Extras

Field	Description
setup<br>Type: setup	Required.<br>Seller’s Facebook setup, such as their unique identifier (external_business_id) or the currency of their catalog (currency). See setup object details.
business_config<br>Type: business_config	Required.<br>Configuration object that the Meta Business Extension uses to configure the Meta Business Extension workflow. See business_config object details.
repeat<br>Type: boolean	Required.<br>Set this value to false.

Setup

Use this object to define the settings for the end user's Facebook presence

Field	Description
external_business_id<br>Type: string	Required.<br>Unique business ID to represent your client's business. We use this as a unique identifier. For example, if the seller's company is called "Fubar", then "fubar-123" could be their external_business_id.
timezone<br>Type: string	Required.<br>The time zone in which the business is located. See possible time zone values.
currency<br>Type: string	Required.<br>Three-letter ISO currency code of the default currency used by the business's catalog items. See supported currency codes.
business_vertical<br>Type: enum	Required.<br>Vertical associated with the business<br>Values:MESSAGING
channel<br>Type: enum	Required.<br>Provides a way for the partner to configure the flow of FBE. For the Messaging flow, this value should be MESSAGING.<br>- MESSAGING, Flow that allows end users to create or select Business Manager, Ad Account, Facebook Page, and Instagram account. Setting up with these assets enables the end user to manage conversations with their customers at scale.
business_manager_id<br>Type: string	Optional.<br>Business Manager ID for user's existing Business Manager that a partner can enter to preselect for the user in the setup flow.
ad_account_id<br>Type: string	Optional.<br>Ad Account ID for user's existing ad account that a partner can enter to preselect for the user in the setup flow.
page_id<br>Type: string	Optional.<br>Page ID for the user's existing Facebook Page that partner can enter to preselect for the user in setup flow.
ig_profile_id<br>Type: string	Optional.<br>Instagram Business Profile ID for the user's existing Instagram Business Profile that a partner can enter to preselect for the user in the setup flow.

Business Config

Use this object to configure the business settings for an end user. This includes CTAs, Services card, and more. Each field includes a "type" linked to the respective tables below.

Field	Description
business<br>Type: FBEBusinessPropertiesConfigData	Required.<br>Information for the end user's business
messenger_chat<br>Type: FBEMessengerChatConfigData	Optional.<br>Messenger chat features on the end user's Facebook page, such as enabled and domains
messenger_menu<br>Type: FBEMessengerMenuConfigData	Optional.<br>Features for the Messenger persistent menu feature, such as cta_button-text and cta_button_url

Next Steps

• Get Webhook notifications about businesses installing and uninstalling FBE.
• Fire pixel events for every FBE-integrated business on your platform.
• Add entry point to our Feature Management View from your surface.
• Allow businesses to uninstall FBE.
• Submit for FBE Integration Review. Once your integration is approved, your app will be available to public users.