What you need before connecting
When you use Add number in Settings > Data Sources, the assistant opens Meta's own window. To get through it you need:
- A Meta account with admin access to the business that owns (or will own) the number. If you sign in with an account that only has partial access, Meta won't let you finish.
- The number free of conflicts: it can't already be registered on the WhatsApp API under a business you don't control, and if it's an app number, the WhatsApp Business app must be a recent version.
- Depending on your case, Meta may ask you to verify your business before it lets some steps through. That verification happens on Meta's side, not in MB Suite.
"The number is associated with another business"
This is the most common block, and it comes from Meta. The number already has a WhatsApp Business account linked to a business (or a Facebook page) that isn't the one you're connecting from. Two typical cases:
- It's linked to a Facebook page. Unlink it from the WhatsApp Business app (Settings > Business tools) or from the page itself, then try connecting again.
- It's already on the API with another provider (ManyChat, another CRM, another BSP). In that case don't use the "new number" path — use the option "This number already sends through the WhatsApp API", which is the only one that shows numbers linked to another platform. Connecting it in MB Suite doesn't disconnect it from the other one.
Meta asks me to verify my business
Meta asks some businesses to confirm they're a real, legitimate business before unlocking parts of the WhatsApp platform. It's a step you complete on Meta's side, inside your business account, and it can take a little while for Meta to review. Until it's done, some actions stay limited — that's Meta's process, not a fault in MB Suite. Once Meta approves your business, connect the number again from Settings > Data Sources.
MB Suite says "We couldn't add this number"
That message isn't Meta's: it's one of MB Suite's own limits. Each Meta business keeps its own connection in MB Suite —so adding a number from another business doesn't disconnect the ones you have—, and each workspace or Account can have numbers from up to 3 Meta businesses and, by default, up to 20 numbers in total. If a connection goes over either one, MB Suite stops it before saving anything and tells you which limit it was:
- "This workspace has reached the maximum of 3 Meta businesses. Any additional client needs its own Account." — the number belongs to a fourth Meta business. You can keep adding numbers from the 3 you already have (the window lists them); the new client's numbers go in its own Account: use Create an Account (you see it if you have access to Accounts) and connect them from that Account. This limit is fixed: to swap one business for another, first remove all the numbers of the one that's leaving — see Disconnect your WhatsApp line from the CRM.
- "This workspace has reached the maximum of 20 WhatsApp lines. If you need more, contact support." — the limit counts every number in the organization, in any module, whether it's only in Data Sources or already works as a line. Write to support: the MB Suite team can raise it for your workspace or Account.
The number is new and I don't get the verification code
When you add a brand-new number, Meta verifies it by sending a code via SMS or a phone call. You need to be able to receive that SMS or call on the number you're adding. If nothing arrives, check that the number is active and can receive messages, and try the phone-call option instead of SMS. If you bought the number in MB Suite, the SMS never arrives: choose the call option from the start, and make sure you're a receiver of the line with MB Suite open, so the call rings in the dialer. See Connect or buy your WhatsApp line: the 5 ways, step by step.
It asks me to reconnect Meta with "business administration", or WhatsApp shows "Pending permissions"
This means your WhatsApp connection is missing the business administration permission (business_management), which is only needed for the Meta dialog when you list or add numbers — not for receiving and replying to messages, which keep working. You'll see it as an amber Pending permissions chip on the WhatsApp card in Settings > Integrations, or as the message "Reconnect Meta granting business administration" when you try to add a number.
To fix it, reconnect Meta through the WhatsApp card and grant the business administration permission when Meta asks. On the Pending permissions chip you can use Update permissions to do it without disconnecting or losing your setup. Once granted, it stays: connecting a number by coexistence no longer removes it.
Still have questions?
Ask MIA, the MB Suite AI assistant: open it with the MB AI button (⌘J) in the top bar. MIA knows the section you're in, so you can ask it about what you see on screen — and it can also answer how-to questions about using MB Suite.