> ## 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 sign-up popup errors when connecting WhatsApp

> Errors in Meta's sign-up popup when you connect WhatsApp to Flowella: business portfolio, account, phone number, code and WhatsApp Business app.

When you select **Connect WhatsApp** or **Add WhatsApp number**, Flowella opens Meta's sign-up popup (Meta calls it Embedded Signup). Errors inside the popup come from Meta, not Flowella, and Meta shows them in the popup itself, sometimes with a code. This page explains the ones Flowella users meet most, grouped by the popup screen they appear on. On 16 November 2026 Meta added more specific codes for phone number, verification code and WhatsApp Business app problems.

> [!NOTE]
>
> **In Flowella.** After the popup closes, Flowella can show its own message, for example that the connection timed out or that the WhatsApp Business Account is linked to another Flowella organisation. For those, and for a popup that won't open, see [Onboarding troubleshooting](https://knowledge.flowella.io/troubleshooting/onboarding.md#connecting-whatsapp) and [Meta setup troubleshooting](https://knowledge.flowella.io/whatsapp/accounts/setup-sequence.md#troubleshooting).

## Business portfolio and account

| Error or code | What it means | What to do |
| - | - | - |
| "Your Facebook account is too new to create a business account." | New Facebook accounts have to wait before they can create a business portfolio. | Wait a few hours, or sign in with an established Facebook account. |
| "You have reached the limit for the number of Businesses you can create", **1690114**, **1752089** | You've created too many business portfolios, or one is still being created. | Choose an existing business portfolio in the popup. |
| "User does not have permission to create WhatsApp Business Accounts." | You aren't an admin of the business portfolio you chose. | Ask a portfolio admin for full control, or ask them to connect WhatsApp. See [Business portfolio](https://knowledge.flowella.io/whatsapp/accounts/business-portfolio.md). |
| **2388098** | An unverified business can create only a limited number of WhatsApp Business Accounts. | Choose an existing WhatsApp Business Account, or complete [business verification](https://knowledge.flowella.io/whatsapp/accounts/business-verification.md). |
| **2494067** | The business portfolio already has the maximum number of WhatsApp Business Accounts. | Delete an unused one in Meta Business Suite → **Settings** → **Accounts** → **WhatsApp Accounts**, or choose an existing one. |
| **2494030** | Business verification is still in progress. | Check its status in Meta Business Suite → **Security Center**. |
| **2655049**, **2494028** | The WhatsApp Business Account is already shared with another partner. | Remove that partner's access, or create a new WhatsApp Business Account in the popup. |
| **2655089**, **3441040**, **2388107** | The WhatsApp Business Account is restricted. | Resolve the restriction in [Business Support Home](https://business.facebook.com/business-support-home), or choose another account. See [Policy and enforcement](https://knowledge.flowella.io/whatsapp/messaging/policy-and-enforcement.md). |
| **2859009**, **4612001** | Meta requires two-factor authentication on your Facebook account or business portfolio. | Turn on two-factor authentication, then try again. |

## Phone number

| Error or code | What it means | What to do |
| - | - | - |
| "This number is registered to an existing WhatsApp account." | The number is still in use in WhatsApp, the WhatsApp Business app or another provider's platform. | Delete the WhatsApp account on the phone, or ask the other provider to release the number. Wait up to 3 minutes, then try again. To keep using the app, connect with [co-existence](https://knowledge.flowella.io/whatsapp/accounts/co-existence.md) instead. See [Phone numbers](https://knowledge.flowella.io/whatsapp/accounts/phone-numbers.md). |
| "This phone number already exists in your list of phone numbers." | The number is already in this WhatsApp Business Account. | Choose the existing number in the popup. |
| "Phone Number has been blocked." | WhatsApp blocked the number. | Check the alert in WhatsApp Manager → **Overview** or Business Support Home. |
| "You have already linked the maximum number of phone numbers allowed" | You've reached Meta's phone number limit across your accounts. | Delete a number you don't use, or ask Meta support for more. |
| "Your verified name violates WhatsApp guidelines." | The display name doesn't meet Meta's display name rules. | Change the name. See [Display names](https://knowledge.flowella.io/whatsapp/accounts/display-names.md). |
| "Your phone number doesn't appear to be valid." | The number is wrong, or of a type WhatsApp doesn't support, such as an interactive voice response (IVR) line. | Check the number and its country code, or use a different number. |
| **3441051**, **2655011**, **2388002** | The number is invalid, isn't linked to a WhatsApp Business Account, or can't be added. | Check the number. Read the detail in the popup for the exact reason. |

## Verification code

| Error or code | What it means | What to do |
| - | - | - |
| "You have guessed too many times." | Too many wrong codes. | Wait about 12 hours. Then restart the popup, choose the existing account and number, and verify again. |
| "You have requested your code too many times.", **2494158** | Too many code requests in a short time. | Wait for the time the popup shows, then request a code again. |
| "Code couldn't be verified: You tried to register this number too many times." | Too many registration attempts for the number. | Try again later. |
| **2593037**, **2593039**, **2388091**, **2388093** | Meta couldn't send or check the code. | Try again. If it keeps failing, contact Meta through Business Support Home. |

Make sure you can receive an SMS or a voice call on the number before you start. A number behind a phone menu can't receive a voice code.

## WhatsApp Business app numbers (co-existence)

These appear when you connect a number you keep using in the WhatsApp Business app.

| Code | What it means | What to do |
| - | - | - |
| **3441049**, **2655094** | The number is already connected to another business platform from the app. | In the WhatsApp Business app, go to **Settings** → **Account** → **Business Platform**, disconnect the current platform, wait 15 minutes and try again. |
| **2655093** | The account is already shared with another partner, and switching partners isn't supported in this popup. | Disconnect the current partner in the WhatsApp Business app, then connect Flowella. |
| **2655095**, **2655048** | The number isn't registered in the WhatsApp Business app. | Register it in the WhatsApp Business app first, or use a different number. |
| **3441045** | The number isn't eligible yet. | Meta needs to see more activity on the number in the WhatsApp Business app. Keep using the app, then try again later. |
| **4563015** | The WhatsApp Business app is out of date. | Update the app. |
| **3441042** | Co-existence isn't available for numbers from this region. | Use a number from a supported region. |
| **3441041** | The number belongs to a different business. | Unlink it from that business, or use a different number. |
| **2655082** | The number is linked to a Facebook Page. | Remove the Page from the business portfolio in Meta Business Suite, or use a different number. |

## Rate limits and Meta system errors

| Code | What to do |
| - | - |
| **3441033**, **3441046**, **1675004**, **1390006**, **1390008** | You tried too many times. Wait, then try again. |
| **1675030**, **1675012**, **2593030**, **2593035**, **4056009**, **3441003** | Meta had a problem. Try again later. If it continues, contact Meta through Business Support Home. |

If the popup closes without an error and Flowella doesn't show the number, start again and finish every screen without long pauses. If it still fails, contact [Flowella support](https://flowella.io/support) with the exact error, the code and the time.

## Related

* [Setup sequence](https://knowledge.flowella.io/whatsapp/accounts/setup-sequence.md)
* [Onboarding troubleshooting](https://knowledge.flowella.io/troubleshooting/onboarding.md)
* [Phone numbers](https://knowledge.flowella.io/whatsapp/accounts/phone-numbers.md)
* [Co-existence](https://knowledge.flowella.io/whatsapp/accounts/co-existence.md)

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


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