# Cloud API flow | Developer Documentation

<div id="bkmrk-cloud-api-flowupdate">## Cloud API flow

<div><span>Updated: Nov 11, 2025</span></div><div>This document describes the default screens that your business customers will be presented with as they navigate the Embedded Signup flow. Note that if you inject [pre-filled data](/documentation/business-messaging/whatsapp/embedded-signup/pre-filled-data), you can pre-fill some of these screens, and bypass many of them entirely, reducing the likelihood of errors and making it much easier for your business customers to onboard onto the platform. This is the UI flow for the latest version v4.</div><div id="bkmrk-screens"><div id="bkmrk-screens-1"><div>### Screens

</div></div></div><div><div><div id="bkmrk-authentication-scree"><div id="bkmrk-authentication-scree-1"><div>#### Authentication screen

</div></div></div><div>This screen authenticates business customers using their Facebook or Meta Business Suite credentials.</div></div><div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-zxxyxbou.png)</div></div><div><div id="bkmrk-authorization-screen"><div id="bkmrk-authorization-screen-1"><div>#### Authorization screen

</div></div></div><div>This screen describes the data the business customer will be permitting your app to access.</div></div><div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-uxuos8iu.png)</div></div><div><div id="bkmrk-business-asset-selec"><div id="bkmrk-business-asset-selec-1"><div>#### Business Asset Selection Screen

</div></div></div><div>This screen gives customers the option to select existing business assets such as a Meta business portfolio and WhatsApp Business Account.</div><div>Users also have the option to create new assets if they have not reached their portfolio limit.</div></div><div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-5nmdmpwe.png)</div></div><div><div id="bkmrk-business-asset-creat"><div id="bkmrk-business-asset-creat-1"><div>#### Business Asset Creation Screen

</div></div></div><div>This screen gives customers the option to select existing business assets such as a Meta business portfolio and WhatsApp Business Account.</div><div>Users also have the option to create new assets if they have not reached their portfolio limit.</div></div><div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-hkpypcwj.png)</div></div><div><div id="bkmrk-phone-number-additio"><div id="bkmrk-phone-number-additio-1"><div>#### Phone number addition screen

</div></div></div><div>This screen allows the business customer to enter a new business phone number to associate with their WhatsApp Business Account.</div><div>It also allows the customer to choose how they wish to receive their verification code, which they will need to provide in the next step.</div><div>If you are providing phone numbers to your customers, you will have to deliver these codes to your customers, or provide pre-verified numbers instead.</div></div><div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-l764luzb.png)</div></div><div><div id="bkmrk-phone-number-verific"><div id="bkmrk-phone-number-verific-1"><div>#### Phone number verification screen

</div></div></div><div>This screen allows the business customer to verify ownership of the business phone number they entered in the previous step.</div></div><div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-yun2xcjq.png)</div></div><div><div id="bkmrk-permissions-review-s"><div id="bkmrk-permissions-review-s-1"><div>#### Permissions review screen

</div></div></div><div>This screen provides a summary of the permissions the business customer will be granting to your app.</div></div><div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-nxzibvnb.png)</div></div><div><div id="bkmrk-success-screen"><div id="bkmrk-success-screen-1"><div>#### Success screen

</div></div></div><div>This screen indicates that Meta successfully created and associated all of the business customer’s assets (business portfolio, WABA, phone number display profile, and business phone number).</div><div>When the customer clicks Finish, a message event will be triggered, containing the customer’s WABA ID and business phone number ID, which you must then use to onboard the customer to the platform.</div></div><div><div>![](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-umzftstp.png)</div></div></div></div>