zymbler

'Phone Number In Use' error

The number is registered elsewhere. Identify where, and how to release it.

4 min readUpdated By the Zymbler team

During WhatsApp setup you saw this dialog:

Phone Number In Use. This phone number is already registered to a WhatsApp account. To continue, migrate this phone number or disconnect it from the existing account. Then, return to this page and try again. It can take up to 3 minutes for the number to refresh.

A WhatsApp number can only live in one business platform at a time. Where Meta allows it, it can stay on your WhatsApp Business app while Zymbler uses it, so the first thing to work out is where the number actually is. Only a number held by another provider has to be released.

Note
Already know where the number is?
Jump directly to Use a number that is already on WhatsApp — it has the step-by-step for each scenario.

Quick triage

  1. Is the number on the WhatsApp Business app? → Then it does not need releasing: where Meta allows it, it can stay on your phone and run in Zymbler at the same time. See Use a number that is already on WhatsApp.
  2. Is it on the consumer WhatsApp app (green icon)? → Install the WhatsApp Business app on that phone and let it move the number across — that keeps your chats. Deleting the account is the last resort.
  3. Is it connected to another WhatsApp Business Solution Provider (for example Twilio, Vonage or 360dialog)? → It's held in their account. Release it from their dashboard.
  4. None of the above? → It may be on a Meta WABA you don't remember. Check business.facebook.com → WhatsApp Manager across all your Meta Business Accounts.

If you released the number and still see the error

The most common reasons it sticks:

  • You haven't waited long enough. Meta's registry can take up to 15 minutes to refresh, even though the dialog says 3 minutes. Give it 15, then retry.
  • You released from one place but it's also on another. Some numbers were active on both the consumer app AND a BSP. Clear both: release from the BSP, and move the number off the consumer app onto the WhatsApp Business app.
  • You released but didn't confirm. Some BSP dashboards have a confirmation step (email click, OTP). Without it, the number isn't actually released.
  • You're trying to add it to a different Business Account than the one it was released from. Should still work — but slower (~15 minutes). Verify under the right account.

Diagnostic: where IS the number?

If you genuinely don't know, run this 30-second test:

  1. Open WhatsApp on any other phone.
  2. Try to send a message to the number as if it were someone else's.
  3. If a profile appears, the number is registered on WhatsApp: on an app or with a provider. Check your own phones first. On the WhatsApp Business app, nothing needs releasing: connect it as it is, where Meta allows it (see Use a number that is already on WhatsApp). On the consumer app, move it to the WhatsApp Business app first, which keeps your chats. If neither app on your phones has it, a provider or another WABA holds it, and that one has to release it.
Tip
Edge case: SIM reused after release
If you released the number from a BSP and then opened the consumer WhatsApp app on a phone with that SIM, it re-registers there on first launch. Install the WhatsApp Business app on that phone and let it take the number over — and don't open the consumer app on the SIM's phone in the meantime.

When nothing else works

A small percentage of numbers get into a stuck state in Meta's registry. If you've waited 24 hours after releasing from every known source and the error persists:

  1. File a support ticket with Meta from business.facebook.com → Help → Support.
  2. Include: the number (with country code), where you last had it registered, when you released it, and screenshots of the error.
  3. In the meantime, you can connect a different number. When the stuck one clears, add it from Channels with Add number.

What to read next

Not using Zymbler yet? Try our demo agent on WhatsApp

Still stuck?
We typically reply within one working day.
Email support