> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta's sign-up popup: what happens when you connect

> What each screen of Meta's sign-up popup does when you connect WhatsApp to Flowella, the permissions you grant, and what Flowella does afterwards.

When you select **Connect WhatsApp** or **Add WhatsApp number** in Flowella, Meta opens its own sign-up popup, which Meta calls **Embedded Signup**. In it, you sign in with Facebook, choose or create a business portfolio and WhatsApp Business Account, add and verify a phone number, and approve the permissions Flowella needs. Everything in the popup happens on Meta's side. When you select **Finish**, Meta tells Flowella which account and number you chose, and Flowella completes the connection.

> [!NOTE]
>
> **In Flowella.** Supported. Flowella uses Meta's current popup (version 4), which also offers to connect a number you keep using in the WhatsApp Business app ([co-existence](https://knowledge.flowella.io/whatsapp/accounts/co-existence.md)). For the order of the whole set-up, see [Setup sequence](https://knowledge.flowella.io/whatsapp/accounts/setup-sequence.md). For errors inside the popup, see [Sign-up popup errors](https://knowledge.flowella.io/whatsapp/errors/embedded-signup-errors.md).

## The screens

| Screen | What you do | What to watch for |
| - | - | - |
| **Sign in** | Sign in with the Facebook account that manages your business. | Use an account that's an admin of your business portfolio. A brand-new Facebook account may have to wait before it can create a portfolio. |
| **Authorisation** | See what data Flowella will be able to access. | Read it, then continue. |
| **Business portfolio and account** | Choose an existing business portfolio and WhatsApp Business Account, or create new ones, with the display name and category the number will show. | Choose the portfolio that's verified, or will be. An unverified business can create only a limited number of WhatsApp Business Accounts. See [Business portfolio](https://knowledge.flowella.io/whatsapp/accounts/business-portfolio.md). |
| **Phone number** | Enter the number and choose how to get the code (SMS or voice call). To keep using the WhatsApp Business app, choose to connect your existing app. | The number mustn't be in use in WhatsApp unless you're connecting with co-existence. See [Phone numbers](https://knowledge.flowella.io/whatsapp/accounts/phone-numbers.md). |
| **Verification** | Enter the code Meta sends to the number. | Too many wrong codes lock you out for about 12 hours. |
| **Permissions review** | See a summary of the permissions you're granting Flowella. | Accept every permission Meta lists, or Flowella can't work properly. |
| **Success** | Select **Finish**. | Don't close the popup or the Flowella tab before you select **Finish**. |

For a co-existence number, the popup shows a code or QR code to enter in the WhatsApp Business app instead of an SMS or call. See [Connect your WhatsApp Business app number](https://knowledge.flowella.io/whatsapp/accounts/co-existence.md#connect-your-whatsapp-business-app-number).

## The permissions you grant

| Permission | What it lets Flowella do |
| - | - |
| `whatsapp_business_messaging` | Send and receive messages on your number, and register the number |
| `whatsapp_business_management` | Manage templates, Flows and phone number settings on your WhatsApp Business Account |
| `whatsapp_business_manage_events` | Send conversion events to Meta, for example for Click to WhatsApp ad leads |
| `business_management` | Read the business portfolio the account belongs to, for example its verification status |

You can remove Flowella's access to your WhatsApp Business Account at any time in Meta Business Suite. Removing it stops Flowella sending and receiving on that account. To stop using one number but keep the account connected, select **Remove** in **Settings → WhatsApp (Meta)** instead. See [Remove a number](https://knowledge.flowella.io/account/meta-integration.md#remove-a-number).

## What Flowella does after you select Finish

**1. Records the account and number**

Meta passes Flowella the WhatsApp Business Account ID and phone number ID you chose. Flowella adds the number as a channel in **Settings → WhatsApp (Meta)**.

**2. Subscribes to your account's events**

Flowella subscribes to the account's webhooks, so incoming messages, delivery statuses and template updates reach it.

**3. Registers the number**

If the number isn't registered on the WhatsApp Business Platform yet, Flowella registers it. See [Add, verify and register](https://knowledge.flowella.io/whatsapp/accounts/phone-numbers.md#add-verify-and-register).

You then finish the set-up yourself: [business verification](https://knowledge.flowella.io/whatsapp/accounts/business-verification.md) and a [payment method](https://knowledge.flowella.io/whatsapp/accounts/payment-method.md) on the WhatsApp Business Account.

## If something goes wrong

* **The popup doesn't open or closes straight away:** allow pop-ups for Flowella and turn off ad or script blockers. See [Onboarding troubleshooting](https://knowledge.flowella.io/troubleshooting/onboarding.md#connecting-whatsapp).
* **The popup shows an error:** look it up in [Sign-up popup errors](https://knowledge.flowella.io/whatsapp/errors/embedded-signup-errors.md).
* **The popup finished but the number isn't in Flowella:** start again and finish every screen without long pauses. If it keeps happening, contact [Flowella support](https://flowella.io/support) with the time.

## Related

* [Setup sequence](https://knowledge.flowella.io/whatsapp/accounts/setup-sequence.md)
* [WhatsApp Business Account](https://knowledge.flowella.io/whatsapp/accounts/whatsapp-business-account.md)
* [Sign-up popup errors](https://knowledge.flowella.io/whatsapp/errors/embedded-signup-errors.md)
* [Co-existence](https://knowledge.flowella.io/whatsapp/accounts/co-existence.md)

Checked against Meta's [Embedded Signup default flow](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/default-flow) and [Embedded Signup overview](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/overview) pages on 18 November 2026.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.