Version 4
Updated: Dec 5, 2025 Release date: October 8, 2025. Check back soon for updates on additional supported products. To upgrade to the version 4 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.What’s new
Simplified onboarding experience for businesses: You can onboard businesses to more business messaging in a single flow ( see supported products). Asset selection, business information, and permissions are each consolidated onto a single page. Asset admins can share assets from other business portfolios. Phone numbers are auto-linked to Facebook Pages when onboarding to ads that click to WhatsApp via the Marketing API. Value proposition and Terms of Service are clearly presented. The Facebook Login for Business Configuration is used to define which products to add into your onboarding flow.Learn more
Version 4 - Cloud API flowSupported products
ESv4 supports additional business messaging products, ensuring businesses to set up and manage multiple communication channels from a single platform: Conversions API (WhatsApp): Track and optimize messaging interactions by selecting the messaging platform you want to monitor, enabling enhanced measurement and optimization. Click to WhatsApp Ads (CTWA): Create ads that direct users to initiate WhatsApp conversations with your business. Click to Messenger Ads (CTM): Run advertising campaigns that start conversations with users on Facebook Messenger. Click to Direct Ads (CTD): Launch Instagram ad campaigns that drive users to direct messaging conversations on Instagram Direct.All other supported products
ESv4 continues to support existing business messaging products, allowing businesses to seamlessly manage their established communication channels. Cloud API: Integrate and manage WhatsApp messaging at scale, enabling businesses to send and receive messages, automate workflows, and access advanced messaging features. Marketing Messages API for WhatsApp: Utilize to manage optimized marketing messaging , providing tools for message analytics, and enhanced customer engagement. WhatsApp Business App users (aka “Coexistence”) support: Onboarding via Coexistence continues to be supported through thefeature_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
ESv4 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 ESv4, 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) |
|---|---|---|
| Cloud API | WhatsApp Business accounts | whatsapp_business_management whatsapp_business_messaging |
| Click to WhatsApp (CTWA on Marketing API) | WhatsApp Business accounts Facebook Pages Ad accounts | ads_read ads_management pages_manage_ads pages_read_engagement pages_show_list |
| Click to Messenger (CTM on MAPI) | Facebook Pages Ad accounts | ads_management pages_manage_ads pages_read_engagement pages_show_list |
| Click to Instagram (CTD on MAPI) | Facebook Pages Ad accounts Instagram accounts | ads_management pages_manage_ads pages_read_engagement pages_show_list |
| Marketing Messages API for WhatsApp | WhatsApp Business accounts | whatsapp_business_management whatsapp_business_messaging |
| Conversions API for CTWA | WhatsApp Business accounts Pixels | whatsapp_business_manage_events |
| Conversions API for CTM | Facebook Pages Ad accounts Pixels | page_events |
| Conversions API for CTD | Facebook Pages Ad accounts Instagram accounts Pixels | instagram_manage_events |
ON THIS PAGE
What’s new
Learn more
Supported products
All other supported products
Use the Facebook Login for Business Configuration to get started with v4
Required assets and permissions