When you connect a number through Channels → New WhatsApp Connection → WhatsApp Business API, a window from Meta opens. That window is Meta's Embedded Signup, not part of 2Chat. When it shows an error, the cause is almost always something in your Meta Business Manager — which means retrying in 2Chat won't change the result until it's fixed there.
Find your error below. Each one tells you what it means, what to check, and whether it's something you can fix or something we need to fix for you.
"The business is already sharing this WhatsApp Business account with a partner"
What it means: Your WhatsApp Business Account (WABA) is already linked to a solution partner. Usually this comes from an earlier connection attempt that was started but never finished — with us, or with another platform you tried before.
How to check who the partner is:
In the left menu, open Accounts → WhatsApp Accounts
Select the WABA you're trying to connect
Open the Partners tab
What to do, depending on what you see:
Another provider you used before — remove the partner there, then start the connection again in 2Chat.
2Chat listed as a partner, and you never added it — this one you cannot fix yourself, and you shouldn't try. It means a signup was started against our app and never completed, which leaves your WABA linked to us. Contact our team and we'll unlink it from our side. Send us your WhatsApp Business Account ID and the phone number you're trying to connect.
One thing that often confuses people: if the same number reaches the QR screen on a different provider, that does not mean the WABA is free. The partner link belongs to the WhatsApp Business Account, not to the phone number. A number can be eligible while its WABA is still held by a partner.
"You already have a WhatsApp Business account" or the number is already registered
What it means: The phone number is already registered to a WhatsApp Business Account — either one of yours, or one created during a previous attempt.
What to do:
In WhatsApp Accounts, check whether the number already appears under one of your WABAs. If it does and you don't need that WABA, delete the number from it and retry.
If the number is currently active in the WhatsApp Business app and you want to keep using the app, don't delete anything — you need the coexistence path instead. Choose the option that says you already use the WhatsApp Business App when you start the connection.
If the number belongs to a WABA you can't see or access, contact us with the number and we'll help you trace where it's registered.
Registration fails with error 141000 or 141006
What it means: These codes come back from Meta at the final registration step — after the signup window has already closed successfully. The connection looks like it worked, but the number never becomes usable.
What to do: These are Meta-side registration failures and the exact cause varies. Contact us with the error code and the phone number. We can read the full failure reason on our side and tell you whether it's a retry, a two-step PIN issue, or something that needs to be cleared in your Business Manager first. Retrying on your own usually reproduces the same error.
The signup finished, but the number never appeared in 2Chat
What it means: Meta's window closed without an error, but no channel shows up in Channels. This is most common on coexistence connections, where the number stays active in the WhatsApp Business app.
What to do:
Give it a few minutes and reload Channels — coexistence connections can take longer to finish than a new number.
Confirm the number appears under WhatsApp Accounts → your WABA → Phone numbers in Business Manager. If it's not there, the signup didn't complete and you can start again.
If it is there but 2Chat doesn't show it, contact us. Don't start a second signup — a second attempt can create a duplicate WABA that then blocks the first one.
"I don't have a Meta Business account"
What it means: WhatsApp Business API requires a Meta Business Manager portfolio. A personal Facebook account isn't enough, and a Facebook Page on its own isn't enough either.
What to do: Create one at business.facebook.com/overview. You'll need your legal business name, a website, and a business email address. It usually takes a few minutes. Once it exists, come back to Channels and start the connection again.
You don't need your business to be verified by Meta before connecting. Verification affects your messaging limits later, not your ability to connect.
#2859043 — "We noticed you're attempting to access this business from a new device or location"
What it means: This is a security check on your Facebook account, not a problem with your WhatsApp account or your number. Meta shows it when it sees a sign-in to your business from a device or location it doesn't recognize, and it appears before the QR code step. Until you complete the check, Meta won't let the connection continue.
What to do:
In Meta's window, complete the verification Meta asks for. If the window doesn't offer one, refresh the page, or open business.facebook.com in another tab and verify when Meta prompts you.
Once Meta confirms it's you, start the connection again from Channels → New WhatsApp Connection → WhatsApp Business API.
Your WhatsApp account, your number and the WhatsApp Business app aren't affected, so there's nothing to delete or reset.
When to contact us: If you completed the verification and the same message keeps appearing, contact us with a screenshot of the error and the exact text.
#2388008 — "The time zone can't be changed after you've chosen a payment method for your account"
What it means: This appears at the Confirm or edit your WhatsApp Business account step when your WhatsApp Business Account (WABA) already exists and already has a payment method. Meta sets a WABA's billing time zone when its payment method is added, and any time zone different from the current one counts as a change, so Meta blocks it.
What to do:
Look up the time zone your WABA already has: in Meta Business Suite, open Billing and payments for that WhatsApp Business account.
Start the connection again, and at Confirm or edit your WhatsApp Business account choose exactly that time zone.
You don't need to remove the payment method, and the WhatsApp Business app on your phone keeps working while you retry.
When to contact us: If the error repeats with the matching time zone, or you can't find the time zone on the WABA, contact us with the exact error text, your WhatsApp Business Account ID and the phone number you're connecting.
Still stuck?
If none of the above matches what you're seeing, or if you followed the steps and the error repeats, start a chat with us and include:
The exact error text or code from Meta's window
Your WhatsApp Business Account ID
The phone number you're connecting, in full international format
Whether the number is currently active in the WhatsApp Business app
Embedded Signup errors are usually account-state problems rather than setup mistakes, so a screenshot of the error plus those four details is normally enough for us to resolve it without any back and forth.
