Skip to content

How to Migrate Your Number to the WhatsApp Business API

"Migrating to the API" can mean two different jobs, and the steps are different for each.

  • From the WhatsApp Business app to the API: either delete the app account and register the number to the API, which loses your app chat history, or use coexistence, which keeps the app and your history.
  • From one API provider to another: under Meta's new account model, the number no longer moves. You share your WhatsApp account with the new provider, and conversations carry on without a break.

Every Meta detail below was checked against Meta's developer documentation on October 22, 2026.

Before you start

  • Back up your chats. If there's any chance you'll delete the app account, back up first. Meta's own guide reminds you to do this.
  • Decide whether you still want the app. This one choice decides which path you take.
  • Have your Meta business login ready. Onboarding runs through Meta's signup flow, where you pick or create a business portfolio.
  • Match your business details. The business name you enter should match your registration documents.
  • Plan for a payment method. Meta bills API messages per message, so you'll need one to send templates.

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.

Path 1: move the number to the API only

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:

  1. Back up your chat history from the WhatsApp Business app.
  2. In the app, go to Settings > Account > Delete my account and follow the steps.
  3. Wait. It can take up to 3 minutes before the number is free to register. Messages sent to the number in the meantime are queued.
  4. Register the number with your API provider and verify it with the code Meta sends.

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.

Path 2: keep the app 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:

  • You need WhatsApp Business app version 2.24.17 or later.
  • If you choose to share it, up to 180 days of one-to-one chat history syncs to your provider. Older media mostly doesn't come across, and group chats don't sync.
  • The sync has to finish within 24 hours of onboarding, or the process starts again.
  • Sending speed is fixed at 20 messages per second.
  • The phone has to stay in use. If the app isn't used for about 14 days, the number is disconnected from the API.

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.

Which path fits

API onlyCoexistence
WhatsApp Business appAccount deleted; number leaves the appKeeps working on your phone
Chat historyLost on the number; only your own backup remainsKept in the app; up to 180 days can sync to the API
Group chatsGone with the app accountStay in the app; not on the API
Sending speedStandard API throughputFixed at 20 messages per second
Message costsEvery message billed by MetaApp messages free; API messages billed
Going backDeregister it from the API, then set it up in the app againDisconnect 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.

Moving between API providers: what changed in 2026

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:

  • A WhatsApp account holds one phone number, the business profile and catalogs. You always own it, and you can share it with more than one provider.
  • A Messaging account holds templates, billing and webhooks. Each provider you work with gets its own.

So switching providers now looks like this:

  1. Start the new provider's signup flow and share your existing WhatsApp account with it. The number doesn't move and conversations aren't interrupted.
  2. Bring your templates over. Templates belong to a Messaging account, so you either recreate them or copy them with Meta's template migration tool. That works between Messaging accounts owned by the same business, for approved templates with a green or unknown quality score. Migrated templates start again at baseline quality and messaging tier, which Meta says takes about 2 to 4 weeks to ramp back up.
  3. Set up billing on the new Messaging account.
  4. When you're ready, remove the old provider in Meta Business Suite by unsharing its Messaging account first, then the WhatsApp account.

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.

Migrating a number in HaberChat

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.

Mistakes to avoid

  • Deleting the app account without a backup. Once it's gone, the history on that number doesn't come back.
  • Using the personal WhatsApp app. Coexistence only works with the WhatsApp Business app. Switch to it first, restoring your backup when it asks.
  • Closing the window during the sync. Keep the app and the signup window open until it finishes.
  • Forgetting the phone afterwards. On coexistence, a phone left unused for about two weeks drops the API connection.
  • Following pre-2026 provider-switch guides. Number migration between providers has been replaced by sharing.

Frequently asked questions

Do I lose my chat history when I move to the WhatsApp Business 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.

Can I keep using the WhatsApp Business app after migrating?

Yes, with coexistence. The number stays active in the app while it's connected to the API. Messages sent from the app stay free.

How do I move my number to a different API provider?

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.

Do I need to turn off two-step verification first?

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.

Try HaberChat free for 7 days

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.