Cloud API to CoEx migration guide
Learn how to move a WhatsApp number from Cloud API to Coexistence on DoubleTick, including the mandatory 7-day WhatsApp Business App waiting period.
If your WhatsApp phone number is currently connected to DoubleTick through Cloud API and you want to switch to Coexistence, this guide walks you through the full migration process from start to finish. In Cloud API, your number is connected exclusively to the WhatsApp API. In Coexistence, the same number can be used simultaneously on both the WhatsApp Business App and the WhatsApp API through DoubleTick — giving you the flexibility to manage conversations from both the app and the platform at the same time.
What's covered
What happens during this migration
Migrating from Cloud API to Coexistence is a multi-step process. You'll need to delete the number from Facebook Business Manager, re-register it on the WhatsApp Business App, use it actively for seven days, link it to the correct Meta Business Portfolio, and then complete Coexistence onboarding inside DoubleTick.
Before you begin
Make sure you have:
Admin access to the correct Meta Business Portfolio.
Access to business.facebook.com.
Access to your DoubleTick account.
Access to the phone number you want to migrate.
The ability to receive an OTP via SMS or phone call.
A mobile device where you can install or access the WhatsApp Business App.
Important: assets you may lose after deleting the number
When you delete a phone number from Facebook Business Manager, you may permanently lose approved message templates, your current messaging limit, Official Business Account (OBA) status, and any webhook or integration setup associated with the number. This action cannot always be reversed — make sure you understand the impact before deleting the number.
Step by step migration process
Step 1: Delete the phone number from Facebook Business Manager To start, remove your phone number from its existing Cloud API configuration in Meta. Log in to business.facebook.com with admin access, open the correct Business Portfolio, and go to Business Settings → Accounts → WhatsApp Accounts. Select the WhatsApp Business Account containing your number, delete the phone number, and confirm. Wait a few minutes for Meta to update before moving to the next step.
Step 2: Register the number on the WhatsApp Business App Download and open the WhatsApp Business App on your phone, then enter the same phone number you deleted from Facebook Business Manager and verify it using the OTP. Once verified, complete your business profile setup in the app.
Once set up, you must use the WhatsApp Business App actively for seven days before you can onboard the number on Coexistence. This waiting period is a requirement from Meta and cannot be skipped.
Step 3: Link the number to your Meta Business Portfolio After the 7-day waiting period, log in to business.facebook.com, open the correct Business Portfolio, and go to Accounts → WhatsApp Accounts. Click Add → Link a WhatsApp Business Account, enter your phone number with the country code, and click Continue. Meta will send a verification code to your WhatsApp Business App. Open the app, enter the code in the pop-up, and click Continue to link the number to your Meta Business Portfolio.
Step 4: Complete Coexistence onboarding on DoubleTick
Log in to your DoubleTick account using your registered mobile number and OTP, then go to Settings → Manage Channels and click Connect new channel. In the pop-up, select Add Number using Embedded Sign-up, then choose Coexistence Onboarding, select Connect Your Existing WhatsApp Business Number, and click Confirm and Proceed.
Log in to Facebook if needed and click Continue, then select the correct Business Portfolio, open the WhatsApp Business Account dropdown, select Connect WhatsApp Business App, and click Next. Enter the same phone number with the country code and click Next — if you see an option like Connect Existing Business App, click Next again.
A QR code will appear: open the WhatsApp Business App on your mobile phone, tap Connect on the message from Facebook Business, and scan the QR code with your camera. The import of your contacts and chat history from the last 6 months begins automatically, so wait for it to complete. Select your correct time zone, click Next, then click Confirm.
Once connected, click Finish — the status will change to Connected once setup completes.
Your WhatsApp Business number is now successfully migrated from Cloud API to Coexistence on DoubleTick — you can now use the same number on both the WhatsApp Business App and the DoubleTick platform simultaneously.
Key takeaways
This migration involves deleting the number from Facebook Business Manager, re-registering it on the WhatsApp Business App, and completing Coexistence onboarding on DoubleTick.
Deleting the number may permanently lose approved templates, messaging limits, OBA status, and webhook or integration setup — review this carefully before proceeding.
Meta requires the number to be active on the WhatsApp Business App for seven days before it can be onboarded on Coexistence. This waiting period cannot be skipped.
After migration, the number works simultaneously on both the WhatsApp Business App and DoubleTick.
Frequently asked questions
What do I lose when I delete the number from Facebook Business Manager? You may permanently lose approved message templates, your current messaging limit, Official Business Account status, and any webhook or integration setup tied to the number. Review this carefully, as it can't always be reversed.
Why do I need to wait 7 days before onboarding on Coexistence? Meta requires the number to be actively used on the WhatsApp Business App for 7 days after registration before it's eligible for Coexistence onboarding. This requirement cannot be skipped.
Can I use the number on both the app and DoubleTick after migrating? Yes — that's the point of Coexistence. Once migrated, the number works simultaneously on the WhatsApp Business App and the DoubleTick platform.
What access do I need before starting this migration? Admin access to the relevant Meta Business Portfolio, access to business.facebook.com and your DoubleTick account, access to the phone number, and the ability to receive an OTP.
How much chat history transfers during this migration? Up to the last 6 months of contacts and chat history import automatically once you scan the QR code during Coexistence onboarding.
Related topics
Last updated