# Version 4 | Developer Documentation

<div id="bkmrk-version-4updated%3A-de">## Version 4

<div><span>Updated: Dec 12, 2025</span></div><div><span></span><div>Release date: October 8, 2025. Check back soon for updates on additional supported products.</div></div><div>To upgrade to the v4 experience: You need to create a new [Facebook Login for Business Configuration](/books/meta-whatsapp/page/implementation-developer-documentation), and select your desired products. Selecting the products will automatically set you to v4.</div><div>See [screenshots](/books/meta-whatsapp/page/version-4-developer-documentation) below.</div><div id="bkmrk-overview-of-v4-chang"><div id="bkmrk-overview-of-v4-chang-1"><div>### Overview of v4 changes

</div></div></div>
<span>Simplified onboarding experience for businesses: </span>
<span>You can onboard businesses to more business messaging in a single flow ([see supported products](/books/meta-whatsapp/page/version-4-developer-documentation)).</span><span>Asset selection, business information, and permissions are each consolidated onto a single page.</span><span>Asset admins can share assets from other business portfolios.</span><span>Phone numbers are auto-linked to Facebook Pages when onboarding to ads that click to WhatsApp via the Marketing API.</span><span>Value proposition and Terms of Service are clearly presented.</span><span>The [Facebook Login for Business Configuration](/books/meta-whatsapp/page/version-4-developer-documentation) is used to define which products to add into your onboarding flow.</span><div id="bkmrk-learn-more"><div id="bkmrk-learn-more-1"><div>### Learn more

</div></div></div>
<span>[v4 - Cloud API flow](/books/meta-whatsapp/page/customizing-the-default-flow-developer-documentation)</span><div id="bkmrk-supported-products"><div id="bkmrk-supported-products-1"><div>### Supported products

</div></div></div><div>v4 supports additional business messaging products, ensuring businesses to set up and manage multiple communication channels from a single platform:</div>
<span>**Conversions API (WhatsApp)**: Track and optimize messaging interactions by selecting the messaging platform you want to monitor, enabling enhanced measurement and optimization.</span><span>**Click to WhatsApp Ads (CTWA)**: Create ads that direct users to initiate WhatsApp conversations with your business.</span><span>**Click to Messenger Ads (CTM)**: Run advertising campaigns that start conversations with users on Facebook Messenger.</span><span>**Click to Direct Ads (CTD)**: Launch Instagram ad campaigns that drive users to direct messaging conversations on Instagram Direct.</span><div id="bkmrk-all-other-supported-"><div id="bkmrk-all-other-supported--1"><div>### All other supported products

</div></div></div><div>v4 continues to support existing business messaging products, allowing businesses to seamlessly manage their established communication channels.</div>
<span>**Cloud API**: Integrate and manage WhatsApp messaging at scale, enabling businesses to send and receive messages, automate workflows, and access advanced messaging features.</span><span>**Marketing Messages API for WhatsApp**: Utilize to manage optimized marketing messaging , providing tools for message analytics, and enhanced customer engagement.</span><span>**WhatsApp Business App users (aka “Coexistence”) support**: Onboarding via Coexistence continues to be supported through the [`feature_type` parameter](/books/meta-whatsapp/page/onboarding-whatsapp-business-app-users-aka-coexistence-developer-documentation).</span><span>**Partner-led Business Verification (PLBV) support**: [PLBV](/books/meta-whatsapp/page/partner-led-business-verification-developer-documentation) 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<span>⁠</span>](https://www.facebook.com/business/help/1091073752691122).</span><span>**Automatic Events API**: [Automatic Events API](/books/meta-whatsapp/page/automatic-events-api-developer-documentation) notifies your application about key events that occur through Click-to-WhatsApp ads.</span><div id="bkmrk-use-the-facebook-log"><div id="bkmrk-use-the-facebook-log-1"><div>### Use the Facebook Login for Business Configuration to get started with v4

</div></div></div><div>v4 enables you to easily set up and change which products you want to include in your onboarding flow:</div><div>Step 1: Navigate to [App Dashboard](https://developers.facebook.com/apps) &gt; **Facebook Login for Business** &gt; **Configurations** to create a new configuration.</div><div>Step 2: Select **Embedded Signup** as the login variation.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-wavztfvv.png)</div><div>Step 3: Select which products you want to include in your onboarding flow. Selecting more than one product is optional.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-q5tyf5ut.png)</div><div>Step 4: Copy the configuration id to use inside the Facebook Login SDK.</div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-erdn1xcl.png)</div><div id="bkmrk-required-assets-and-"><div id="bkmrk-required-assets-and--1"><div>### Required assets and permissions

</div></div></div><div>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.</div><div><table><thead><tr><th><span>Product </span></th><th><span>Required assets </span></th><th><span>Required permissions (Advanced Access) </span></th></tr></thead><tbody><tr><td><div><div>[Cloud API](/books/meta-whatsapp/page/about-the-whatsapp-business-platform-developer-documentation)</div></div></td><td><div><div>WhatsApp Business accounts</div></div></td><td><div><div>whatsapp_business_management</div><div>whatsapp_business_messaging</div></div></td></tr><tr><td><div><div>[Click to WhatsApp (CTWA on Marketing API)](https://developers.facebook.com/docs/marketing-api/ad-creative/messaging-ads/click-to-whatsapp)</div></div></td><td><div><div>WhatsApp Business accounts</div><div>Facebook Pages</div><div>Ad accounts</div></div></td><td><div><div>ads_read</div><div>ads_management</div><div>pages_manage_ads</div><div>pages_read_engagement</div><div>pages_show_list</div></div></td></tr><tr><td><div><div>[Click to Messenger (CTM on MAPI)](https://developers.facebook.com/docs/marketing-api/ad-creative/messaging-ads/click-to-messenger)</div></div></td><td><div><div>Facebook Pages</div><div>Ad accounts</div></div></td><td><div><div>ads_management</div><div>pages_manage_ads</div><div>pages_read_engagement</div><div>pages_show_list</div></div></td></tr><tr><td><div><div>[Click to Instagram (CTD on MAPI)](https://developers.facebook.com/docs/marketing-api/ad-creative/messaging-ads/click-to-instagram)</div></div></td><td><div><div>Facebook Pages</div><div>Ad accounts</div><div>Instagram accounts</div></div></td><td><div><div>ads_management</div><div>pages_manage_ads</div><div>pages_read_engagement</div><div>pages_show_list</div></div></td></tr><tr><td><div><div>[Marketing Messages API for WhatsApp](/books/meta-whatsapp/page/marketing-messages-api-for-whatsapp-developer-documentation)</div></div></td><td><div><div>WhatsApp Business accounts</div></div></td><td><div><div>whatsapp_business_management</div><div>whatsapp_business_messaging</div></div></td></tr><tr><td><div><div>[Conversions API for CTWA](https://developers.facebook.com/docs/marketing-api/conversions-api/business-messaging#ads-that-click-to-whatsapp)</div></div></td><td><div><div>WhatsApp Business accounts</div><div>Pixels</div></div></td><td><div><div>whatsapp_business_manage_events</div></div></td></tr><tr><td><div><div>[Conversions API for CTM](https://developers.facebook.com/docs/marketing-api/conversions-api/business-messaging#ads-that-click-to-messenger)</div></div></td><td><div><div>Facebook Pages</div><div>Ad accounts</div><div>Pixels</div></div></td><td><div><div>page_events</div></div></td></tr><tr><td><div><div>[Conversions API for CTD](https://developers.facebook.com/docs/marketing-api/conversions-api/business-messaging#ads-that-click-to-instagram-direct)</div></div></td><td><div><div>Facebook Pages</div><div>Ad accounts</div><div>Instagram accounts</div><div>Pixels</div></div></td><td><div><div>instagram_manage_events</div></div></td></tr></tbody></table>

</div></div>