What does this error mean?
This error appears when the phone number you are trying to onboard for WhatsApp (Business or API) is already connected to an existing WhatsApp account. A phone number can only be linked to one WhatsApp account at a time. Until it is disconnected from the current account, it cannot be used again for onboarding.
Why am I seeing this error?
You may encounter this error for one of the following reasons:
The number is currently active on the WhatsApp mobile app (personal or business).
The number is already connected to another WhatsApp Business Platform or provider.
The number was recently disconnected, but WhatsApp is still processing the change.
The number was previously used for WhatsApp and not fully released yet.
How to fix this issue
Follow the steps below carefully to resolve the error.
Step 1: Disconnect the number from the existing WhatsApp account
If the number is active on a mobile device:
Open WhatsApp on the phone.
Go to Settings.
Select Account.
Tap Delete Account.
Confirm by entering the phone number.
Important: Deleting the account permanently removes chat history and disconnects the number from WhatsApp.
If the number is connected to another provider:
Contact the current WhatsApp provider and request a full release or deletion of the number from their WhatsApp Business Platform account.
Step 2: Wait for the number to refresh
Once the number is disconnected:
Wait up to 3 minutes for WhatsApp systems to refresh the number’s status.
In some cases, it may take slightly longer depending on WhatsApp’s backend processing.
Do not retry immediately multiple times, as this may cause additional delays.
Step 3: Retry onboarding
After the waiting period:
Return to the onboarding screen.
Re-enter the phone number.
Proceed with the verification steps.
This error is not a system failure. It is a safeguard by WhatsApp to ensure each phone number is uniquely associated with a single account. Once the number is properly disconnected and refreshed, onboarding should complete successfully.