Get Started

We recommend that you read through the entire documentation for this guide prior to starting development, then use the Meta Business Extension Developer Panel to set up your integration.

Before You Start

  • Before beginning implementation, contact your Meta representative. You must be added to the allow list to use this framework.

  • Make sure you have met all requirements.

  • As part of the implementation process, use your Meta-assigned platform name when integrating with our framework. If you don't have one, ask your Meta representative.

  • Identify which vertical(s) your app belongs to:

Use CaseVerticalFeatures

My app makes it easy for businesses to book services.

Appointments

IG CTA, Page CTA, Messenger CTA, Catalog

My app makes it easy for businesses to book reservations.

Reservations

IG CTA, Page CTA, Messenger CTA

My app helps commerce businesses to increase sales and streamline their online ordering process.

E-Commerce

Catalog, Messenger Chat

My app enables restaurants to streamline online orders.

Food Ordering

IG CTA, Page CTA, IG Stories Sticker, Messenger CTA

My app helps businesses to create eye-catching content without the help of a professional graphic designer.

Creative

Creative integrations with Ads

My app supports businesses in managing their customer communication at scale.

Messaging

Messenger chat plugin, Send availability

My app enables businesses to improve marketing decisions with detailed ad insight.

Measurement and Optimization

CAPI

My app helps businesses to collect, track, and nurture leads.

Lead Ads

Lead Ads

My app enables businesses to bring their ads in front of the right customers.

Ads Targeting

Custom Audience Targeting

Set Up Your Integration

Step 1: Add the Meta Business Extension Developer Panel to your Facebook Developer app.

Step 2: Enable onboarding for the verticals you want your app to support:

Step 3: Allow businesses to connect their presence on your platform to their Meta profiles by supporting two authentication flows: one from your platform and one from the Facebook/Instagram platform.

  1. Business Login (commonly known as Facebook Login) -- Allows businesses to initiate the connection from your platform, using a button you place on your site.
    • Loading via URL
    • Loading via SDK
  2. Business Apps - Allows businesses to initiate the connection from Meta surfaces (eg. Facebook and Instagram). To enable this flow and have your app listed on Business Apps, you must provide a custom authentication UI that allows the user to select their business on your site and then redirect them back to the Facebook or Instagram flow.

Step 4: Get the Pixel ID, business ID, Instagram ID, and access token for the businesses on your platform

  1. Get Webhook notifications about businesses installing and uninstalling Meta Business Extension.
  2. Get IDs from our Meta Business Extension Installation API endpoint.

Step 5: Fire Pixel events for these connected businesses.

Step 6: Select and configure business features for your businesses.

  1. Business Configuration Object -- passed in during Business Login and Business Apps flows.
  2. Add entrypoint to our Feature Management View from your surface
  3. Feature Configuration API -- used to make updates after an installation

Step 7: Send us the full inventory for the connected businesses and keep the catalog updated.

Step 8: Allow businesses to manage and uninstall the Meta Business Extension.

Step 9: Submit for Meta Business Extension Integration Review. Once your integration is approved, you can launch your app to be available to public users.