Coexistence Setup Fails After Switching Partners
Why a previous partner's line of credit can block WhatsApp Coexistence onboarding, and how to offboard the number so you can connect it again.
In short: If the WhatsApp Business Account still shares a line of credit from a previous partner, Meta does not let that account be onboarded to Coexistence again. This is by Meta's design. The number has to be fully offboarded first, then onboarded again.
Table of Contents
What You May See
This issue usually appears when a business that used another WhatsApp partner in the past tries to connect its existing WhatsApp Business app number to the CRM through Coexistence.
Why This Happens
A line of credit is how a WhatsApp partner shares its payment method with a client's WhatsApp Business Account so that messaging can be billed.
When the previous partner's line of credit is still active on the account, Meta does not allow that account to be onboarded to Coexistence again. Meta Support has confirmed this is expected behavior and not a fault in the CRM. Meta's documentation describes the same situation: a client who worked with a partner in the past and still shares the previous credit line may see an error when switching to a new partner.
Disconnecting in the app may not be enough. If the offboarding did not complete successfully, the number and its old WhatsApp Business Account stay linked, and the line of credit stays attached. Following the offboarding steps below fixes this.
Before You Start
Do not start by deleting the number from the WhatsApp Business Account in Meta. Although this can let onboarding continue, Meta Support cannot guarantee that the business will keep its chats and contacts if you do this. Use the offboarding options below instead.
Option 1: Standard Offboarding
Start here. This is Meta's standard way to disconnect a number from a connected business platform.
Disconnect in the WhatsApp Business App
On the phone, open the WhatsApp Business app and go to Settings → Account → Business Platform. Select the connected business platform and tap Disconnect Account.
Wait 15 Minutes
Meta asks you to wait about 15 minutes after disconnecting before you try again. Disconnecting removes the number from the associated WhatsApp Business Account and business.
Connect Through the CRM Again
In the sub-account, go to Settings → WhatsApp and connect the number again using the Coexistence method. If it connects, you are done.
↗ WhatsApp Coexistence Method — full setup guideOption 2: Complete Offboarding
If the standard disconnection does not clear the conflict, the number must be fully offboarded and then onboarded again. Meta Support recommends this alternative method when the line of credit is still blocking Coexistence.
Back Up the Chat History
Create a backup in the WhatsApp Business app before changing anything.
Register the Number on the Standard WhatsApp App
Register the business phone number on the standard consumer WhatsApp app, not the WhatsApp Business app. This moves the chats and contacts to the standard app and offboards the number from the WhatsApp Business app. It also delinks the number from the connected business and WhatsApp Business Account.
The standard app does not include business tools from the WhatsApp Business app, so note down anything business-specific you need before this step.
Register the Number Back on the WhatsApp Business App
Register the same number again in the WhatsApp Business app. This creates a new WhatsApp Business Account for the number, which is not linked to any other business or to the old line of credit.
Onboard Through the CRM
Go to Settings → WhatsApp in the sub-account and run the Coexistence onboarding again. Keep the WhatsApp Business app open while chats and contacts sync, which can take several minutes depending on how much history there is.
↗ WhatsApp Coexistence Method — full setup guideHow this relates to Meta's own steps: Meta's documentation for switching partners lists four short steps: back up messages, disconnect from the WhatsApp Business app, reconnect in the WhatsApp Business app, then start the onboarding flow. Per Meta Support, "disconnect" means removing the number from the app so it is delinked from its WhatsApp Business Account, and "reconnect" means registering it in the WhatsApp Business app again, which creates a new WhatsApp Business Account. The consumer-app step above is the additional guidance Meta Support gives when the standard disconnection does not resolve the conflict.
What Happens to Your Chats and Contacts
Complete offboarding (Option 2)
Per Meta Support, registering the number on the standard app moves the chats and contacts across, and no chat information is lost. Back up first as a precaution.
Deleting the number from the WhatsApp Business Account in Meta
Onboarding can then continue, but Meta Support cannot guarantee that chats and contacts will be kept. Avoid this unless the other options fail and you have a backup.
After Coexistence onboarding, Meta syncs up to the most recent six months of one-to-one chats and your contacts to the connected platform. Group chats are not synced.
Troubleshooting
When contacting Support, include: your Location ID, the WhatsApp number, the WhatsApp Business Account ID if you have it, the exact error message shown, which offboarding steps you completed and when, and a screenshot of the error.
Frequently Asked Questions
Q: Is this a problem with the CRM?
No. Meta Support has confirmed that Meta does not allow a Coexistence account with an active line of credit to be onboarded again. This is by Meta's design.
Q: Why is the number not released after the business disconnected it?
The offboarding may not have completed successfully. Follow Option 1, and if that does not work, Option 2.
Q: Does registering on the standard WhatsApp app release the number from the WhatsApp Business app?
Yes. Per Meta Support, this moves the chats and contacts and offboards the number from the WhatsApp Business app, which delinks it from the connected business and WhatsApp Business Account.
Q: Will the customer lose their chats and contacts?
Not with the offboarding options in this article, according to Meta Support, as long as the steps are followed. Always back up first. Deleting the number from the WhatsApp Business Account in Meta carries no guarantee.
Q: Why does the number need to be registered on the WhatsApp Business app again?
Registering it again creates a new WhatsApp Business Account that is not linked to any other business or to the previous partner's line of credit.
Q: Do I need a new phone number?
No. The same number is used throughout. It is offboarded, registered again, and then connected to the CRM.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article