Fix "Phone Number Already Registered to a WhatsApp Account" Error
This error means the phone number is still linked to another WhatsApp account. Delete it from the existing WhatsApp app or provider, wait a few minutes for WhatsApp to refresh, then re-attempt onboarding.
WhatsApp allows one account per phone number. If onboarding in Sparkforge throws "This phone number is already registered to a WhatsApp account," the number is still attached somewhere else and must be released before it can verify.
Why you see this error
- The number is active in the WhatsApp mobile app (personal or business).
- It is connected to a different WhatsApp Business Platform provider.
- It was disconnected very recently and WhatsApp has not finished processing the change.
- It was previously used for WhatsApp and has not fully released.
Step 1: Disconnect the number
If the number is on a phone
- Open WhatsApp on the device.
- Go to Settings.
- Tap Account.
- Tap Delete Account.
- Confirm by entering the phone number.
Note: deleting the account removes chat history and releases the number from WhatsApp.
If the number is on another provider
Contact the current WhatsApp Business Platform provider and request a full release or deletion of the number from their account.
Step 2: Wait for WhatsApp to refresh
- Allow up to 3 minutes after disconnect for WhatsApp to update the number's status.
- Backend processing may take longer in some cases.
- Avoid retrying repeatedly — repeated attempts can extend the delay.
Step 3: Retry onboarding
- Return to the Sparkforge WhatsApp onboarding screen.
- Re-enter the phone number.
- Complete the verification steps.
This is a WhatsApp safeguard, not a Sparkforge limit. Once the number is properly released and refreshed, onboarding completes.
Frequently Asked Questions
Why does WhatsApp say my number is already registered?
How long should I wait between disconnecting and retrying?
Will I lose chat history when deleting the WhatsApp account?
What if my number is on another WhatsApp provider?
Is this a Sparkforge bug?
Was this article helpful?
Thanks for the feedback.