"Migrating to the API" can mean two different jobs, and the steps are different for each.
Every Meta detail below was checked against Meta's developer documentation on October 22, 2026.
If you're starting from scratch rather than moving a number, our guide on how to get the WhatsApp Business API covers signup, verification and starting limits.
Meta won't register a number on the API while it's still active on a WhatsApp account. To go API-only, you remove it from the app first. Meta's documentation describes the steps:
Know what you're giving up. Meta says your existing message history is lost when you go this way, and you can't use the number in the WhatsApp Business app again unless you deregister it from the API. Your backup stays on your phone or cloud storage; it doesn't come across to the API.
This path suits teams that are leaving the app for good and want the full API without the limits that come with coexistence.
Coexistence connects your WhatsApp Business app number to the API while it stays active in the app. Meta calls it onboarding WhatsApp Business app users. You keep your phone, your number and your chats, and the API adds templates and automation. Meta's coexistence documentation sets out the main conditions:
To leave coexistence later, you disconnect from the app itself, under Settings > Account > Business Platform. Coexistence isn't available in every country. We cover the trade-offs, including which app features are switched off, in WhatsApp coexistence explained.
| API only | Coexistence | |
|---|---|---|
| WhatsApp Business app | Account deleted; number leaves the app | Keeps working on your phone |
| Chat history | Lost on the number; only your own backup remains | Kept in the app; up to 180 days can sync to the API |
| Group chats | Gone with the app account | Stay in the app; not on the API |
| Sending speed | Standard API throughput | Fixed at 20 messages per second |
| Message costs | Every message billed by Meta | App messages free; API messages billed |
| Going back | Deregister it from the API, then set it up in the app again | Disconnect from the app's settings |
On either path, API messages cost money. Since October 1, 2026, Meta also charges for replies inside the 24-hour window. Our WhatsApp API pricing guide explains the message types.
Older guides tell you to switch off two-step verification and run a phone number migration to a new WhatsApp Business Account (WABA). That process is gone. Meta's new account model started rolling out on September 23, 2026 and was due to reach all businesses by mid-October. Its documentation now states that moving a number from one provider to another isn't supported.
It isn't needed either. The old WABA has been split into two accounts:
So switching providers now looks like this:
A few things stay with the number and need no action: your conversation history, the number's quality rating, your display name and your business verification. Your messaging limit is set at the business portfolio level, and if two providers share the number for a while, they share its limit and sending speed.
Two limits to know. A number can't be moved to a different business portfolio. Within your own portfolio, you regroup numbers by linking and unlinking WhatsApp accounts in Meta Business Suite, a feature Meta is still rolling out. Meta is also retiring the six-digit two-step verification PIN for eligible Cloud API numbers, so you may find there's no PIN to turn off at all.
If your number is connected to HaberChat by QR code, open its device settings and look for Migrate to WABA. The flow connects your WhatsApp Business app number to the official API through Meta's signup, and the app keeps working on your phone. You confirm the requirements, accept each listed limitation, log in with Facebook, choose or create the WhatsApp Business Account and verify the number. It usually takes 5 to 10 minutes; a large chat history can take longer to sync.
Before you start, note what changes. The migration can't be undone. Linked devices such as WhatsApp Web are signed out and need to be linked again. Groups, channels and status stay in the phone app only. And once the number is on the API, the QR connection is no longer an option for it in HaberChat. A QR connection, by contrast, isn't an official Meta integration, which is one reason teams make this move.
If the number is already connected to another provider, HaberChat's flow asks you to disconnect it there first. The full walkthrough, with troubleshooting, is in our help center: migrating your number to the WhatsApp Business API. Still deciding whether you need the API? See WhatsApp Business app vs API.
Only if you delete the app account and register the number to the API alone. With coexistence, your chats stay in the app and up to 180 days of one-to-one history can sync to your provider.
Yes, with coexistence. The number stays active in the app while it's connected to the API. Messages sent from the app stay free.
Under Meta's new account model, you don't move it. You share your WhatsApp account with the new provider, recreate or copy your templates, and unshare the old provider in Meta Business Suite when you're ready.
Not to switch providers anymore, because the number no longer migrates. Meta is also retiring the two-step verification PIN for eligible Cloud API numbers.
No credit card needed. Connect your number by QR code, invite your team and see if it fits. Start your free trial or compare plans.