Log inStart Free Trial
Meta Tech Provider

Switching to a new phone with a Coexistence number

Moving a Coexistence number to a new phone means registering it again on the new device, and Meta ends the Cloud API connection when that happens, reporting USER_RE_REGISTERED. Back up the WhatsApp Business chats, register the same number on the new phone, restore the backup, open the app, then run Embedded Signup again. The number stays yours; only the API link needs reconnecting.

easyCoexistence shows the reason on the number's page when Meta reports it: "The number was registered again on another device.

USER_RE_REGISTERED

Disconnection reason Meta reports when the client re-registered on a new device.

ACCOUNT_OFFBOARDED

Event Meta sends when the business phone number changes devices and re-registers.

6-digit

The registration code WhatsApp sends to the old phone when the number moves to a new one.

Not possible

WhatsApp's Help Center says chats currently cannot be transferred with chat transfer on the WhatsApp Business app.

4

Companion clients a WhatsApp Business app account can link, all except WhatsApp for Windows and WearOS supported.

Does a new phone end the Coexistence connection?

Yes. A WhatsApp account runs on one primary phone, and moving it means registering the number again on the new device. WhatsApp logs the old phone out as soon as re-registration completes. On the platform side, Meta lists this among the reasons a Coexistence number is disconnected: the account_update webhook arrives with PARTNER_REMOVED and the reason USER_RE_REGISTERED, and Meta also documents an ACCOUNT_OFFBOARDED event for a number that changes devices and re-registers.

The number itself is not affected. It stays the same number, in the same WhatsApp Business app account and the same business portfolio. What ends is the API link, which is restored by onboarding again once the new phone is ready.

How do you keep the chats?

With a backup. WhatsApp's chat transfer feature, which moves chats directly from phone to phone, is not available on the WhatsApp Business app: WhatsApp's Help Center says it is currently not possible to transfer chats on the WhatsApp Business app. The route that works is the app's own chat backup, made on the old phone and restored on the new one during registration.

Make the backup right before the switch, so the latest conversations are in it. Registration on the new phone asks for the 6-digit code WhatsApp sends to the old phone, or by SMS or a call if it does not arrive, and for the two-step verification PIN or email if one is set. Keep the old phone intact until the restore has finished.

What has to be redone on the API side?

Everything a new onboarding resets. Reconnect the number through Embedded Signup from the new phone, then work through the rest.

  • The webhook destination, which Meta removed with the old connection.
  • The history question: the app asks again whether to share chat history, with a fresh 24-hour sync window.
  • Linked devices. Onboarding unlinks every companion; link WhatsApp Web and companion phones again.
  • WhatsApp for Windows and WhatsApp for WearOS stay unsupported on a Coexistence number.
  • Credentials stored in your systems: fetch them again after reconnecting.

What happens to automations and your AI during the switch?

They pause. From the moment the number is registered on the new phone until it is reconnected, the API side is down: automations do not run, AI replies stop and your systems receive nothing. Customers keep reaching the business in the app on the new phone.

Plan the switch for a quiet hour and do the whole sequence in one sitting: backup, registration, restore, opening the app, reconnecting. Afterwards, ask your AI to run get_number_health and confirm the number reads as connected, then send a test message from another phone to check that the automation answered. An AI-reply automation picks up again on its own once the number is connected; nothing needs rebuilding.

Is a new phone the same as changing the number?

No, and the difference decides what happens next. A new phone with the same number is USER_RE_REGISTERED: the same number reconnects to the same WhatsApp Business Account, and anything keyed to it, such as automations and templates, is still there.

Changing the number in the app is CHANGE_NUMBER. The new number is a separate business phone number on the platform with its own phone number ID, and it is onboarded as a new connection from scratch. If a business is changing both at once, finish the number change first, then set up the new phone, then connect the new number a single time.

How to set it up

  1. Back up on the old phoneIn the WhatsApp Business app, back up the chats to the phone's cloud backup and wait until it finishes.
  2. Register the number on the new phoneInstall WhatsApp Business on the new phone and register the same number with the 6-digit code; the old phone is logged out.
  3. Restore and open the appRestore the backup when the app offers it, then keep the app open until the chats have loaded.
  4. Reconnect the numberRun Embedded Signup again with the same portfolio and number, and scan Meta's QR code from inside the app on the new phone.
  5. Re-link devices and check deliveryLink WhatsApp Web or companion phones again, confirm the webhook destination, and send a test message.

Common mistakes

  • Expecting chat transfer to move WhatsApp Business chats. WhatsApp's Help Center says it is not possible on the Business app; use a backup.
  • Wiping the old phone before the restore finishes. If the backup was incomplete, the old phone is the only copy left.
  • Reconnecting from the old phone after registering the new one. The old phone is logged out; the confirmation happens on the new phone.
  • Leaving the new phone unopened once WhatsApp Web is linked again. The 14-day rule now counts on the new phone.
Doing this with EasyCoexistence

Open the app on the phone that holds it now, then reconnect below." Reconnecting updates the same number rather than adding one, and the saved message destination is put back automatically. US$ 9 down to US$ 0.75 per number per month, falling as you add numbers, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Can I keep using the old phone with the same number?

Not as the primary phone. WhatsApp logs it out once the number is registered on the new phone. It can be linked as a companion device afterwards if it is a supported client.

Do my templates survive the switch?

Templates belong to the WhatsApp Business Account, which stays the same when the same number moves to a new phone. Check their status after reconnecting.

Does a factory reset count as a new phone?

Registering the number again after a reset is a re-registration, so expect the same disconnection and plan the same backup and reconnect steps.

How long does the whole switch take?

Registration and the restore depend on the backup size. The reconnection itself takes a couple of minutes once the app on the new phone is ready.

Keep reading

Ready to get started?

Set up WhatsApp Coexistence in minutes, not months. The app keeps working on the phone.

Start Free Trial

Verified on