Version 4 | Developer Documentation
Version 4
Updated: Dec 12, 2025
Release date: October 8, 2025. Check back soon for updates on additional supported products.
To upgrade to the v4 experience: You need to create a new Facebook Login for Business Configuration, and select your desired products. Selecting the products will automatically set you to v4.
See screenshots below.
Overview of v4 changes
Learn more
Supported products
v4 supports additional business messaging products, ensuring businesses to set up and manage multiple communication channels from a single platform:
All other supported products
v4 continues to support existing business messaging products, allowing businesses to seamlessly manage their established communication channels.
feature_type parameter.Partner-led Business Verification (PLBV) support: PLBV enables partners to verify business after onboarding via Embedded Signup. If you are considering this option, ensure you are an approved Select Solution or Premier Solution Partner, and approved for access.Automatic Events API: Automatic Events API notifies your application about key events that occur through Click-to-WhatsApp ads.Use the Facebook Login for Business Configuration to get started with v4
v4 enables you to easily set up and change which products you want to include in your onboarding flow:
Step 1: Navigate to App Dashboard > Facebook Login for Business > Configurations to create a new configuration.
Step 2: Select Embedded Signup as the login variation.

Step 3: Select which products you want to include in your onboarding flow. Selecting more than one product is optional.

Step 4: Copy the configuration id to use inside the Facebook Login SDK.

Required assets and permissions
When selecting products for v4, the flow will automatically select all necessary permissions and assets. You will need advanced access for all permissions automatically selected in the flow. If needed, you can select additional assets and permissions. The table below is a reference on what assets and permissions you need depending on what product you would like to offer.
| Product | Required assets | Required permissions (Advanced Access) |
|---|---|---|
WhatsApp Business accounts | whatsapp_business_management whatsapp_business_messaging | |
WhatsApp Business accounts Facebook Pages Ad accounts | ads_read ads_management pages_manage_ads pages_read_engagement pages_show_list | |
Facebook Pages Ad accounts | ads_management pages_manage_ads pages_read_engagement pages_show_list | |
Facebook Pages Ad accounts Instagram accounts | ads_management pages_manage_ads pages_read_engagement pages_show_list | |
WhatsApp Business accounts | whatsapp_business_management whatsapp_business_messaging | |
WhatsApp Business accounts Pixels | whatsapp_business_manage_events | |
Facebook Pages Ad accounts Pixels | page_events | |
Facebook Pages Ad accounts Instagram accounts Pixels | instagram_manage_events |
No comments to display
No comments to display