Migrating Your Existing Number to the WhatsApp Business API
Your number can move to the API, but it leaves the phone app when it does and the chat history does not come with it. Here is the safe sequence.
Yes, you can keep your existing number. The part that catches people is what happens to it: once a number is connected to the WhatsApp Business API, it stops working in the WhatsApp Business app on your phone. There is no dual mode, on any platform, because it is Meta's rule rather than a vendor limitation.
That single fact drives everything below. Migration is not difficult, but it is one-way in practice, and doing it in the wrong order means a day where customers message a number nobody is watching.
What moves, and what does not
| Moves to the API? | |
|---|---|
| Your phone number | Yes |
| Your display name | Re-set during signup, and reviewed |
| Profile photo, description, hours | Re-enter them once |
| Chat history | No — it stays on the phone |
| Contacts saved in your phone | No — import them separately |
| Labels from the Business app | No — recreate them as tags |
| Catalogue | Held on the business account; check after migrating |
| Quick replies | No — recreate as canned replies or flows |
The two that hurt are chat history and labels. Export any conversation you need for records before you start, because afterwards the app will no longer open on that number.
The safe order of operations
- Export what you need. Chat history for anything contractual, and your contact list as a spreadsheet with numbers in full international format.
- Decide whether to migrate at all. Connecting a second number first is slower but carries no risk, and lets you learn the platform before your main line depends on it.
- Prepare your templates. Write the two or three you know you need — order confirmation, delivery update — so you can submit them the moment the number connects. Approval is usually minutes to a few hours; read why templates get rejected first.
- Pick a quiet window. Early in your slowest day. Not before a sale.
- Delete the WhatsApp Business account on the phone for that number, which releases it. This is the irreversible step.
- Run embedded signup and verify the number by SMS or call — the process in how to get the WhatsApp Business API.
- Set your profile and submit templates immediately.
- Send yourself a test from another phone, both directions.
- Update every link that points at the number — website button, Instagram bio, Google Business Profile, QR codes on packaging.
Steps 5 to 8 take under an hour in practice. The risk window runs from deleting the account to completing signup, which is why step 4 matters.
What your messaging tier will be
Migrating carries over no sending reputation from the app, because the app had no tier. You start where every new API number starts: 1,000 unique customers in a rolling 24 hours, rising to 10,000 and 100,000 before unlimited as volume and quality allow — see Meta's messaging limits.
For a store that answers customers this is irrelevant; 1,000 unique conversations a day is a lot. It only bites if your first act after migrating is a large campaign, which is a bad first act anyway — see messaging limits and tiers explained.
What to check the morning after
- Send and receive a real message from a phone that is not yours.
- Check your display name has been approved — review takes minutes to 48 hours, and until it clears customers see the number rather than your name.
- Confirm your templates are approved and send one to yourself.
- Click every link that points at your number — website, Instagram bio, Google Business Profile.
- Watch the inbox for an hour at your busiest time, to be sure nothing is arriving somewhere nobody is looking.
If something has gone wrong it shows up in the first two. Meta's error code reference covers what any failure message means, and our guide to WhatsApp error codes for merchants translates the common ones into plain English.
The mistakes that cause real damage
Migrating the day before a sale. Template approval, display-name review and your own learning curve all want slack. Give yourself a week.
Forgetting the printed links. The number still works, so packaging is fine — but a wa.me link with a prefilled message is worth re-checking, and any link pointing at a number you abandoned is dead.
Assuming customers notice. They do not, and that is good: to a customer nothing changes. Do not announce a migration.
Not exporting first. The one irreversible mistake on this list.
Expecting to reply to old conversations. After migrating, the 24-hour window applies to every conversation, and threads from the phone are not open. Anyone you were mid-conversation with must message you again, or be reached with an approved template.
Migrating between platforms, not from the app
If your number is already on the API with another provider, this is a different and easier job. The number belongs to your Meta Business Account rather than to the vendor, so what moves is which platform is connected to it.
Templates live on the WhatsApp Business Account and generally survive. What does not survive is your flows — no two builders share a format, so a complex chatbot is a rebuild rather than an export — and your chat history, which stays with the old platform.
The safe sequence has the same shape: build your two most important flows on the new platform against a test number, then move the connection during a quiet window.
Should you migrate at all?
If you are a solo operator answering a handful of messages a day, the honest answer may be no — see the Business app versus the API for the three cases where staying put is right.
If two or more people answer customers, or you want automation or campaigns, migration is the only route and the cost of delaying is a team sharing one phone. Connect a second number this week, learn the platform, and move the main line when you are comfortable.
Frequently asked questions
Can I keep my WhatsApp number when moving to the API?
Yes. The number migrates, but it stops working in the WhatsApp Business app on your phone once connected — Meta does not allow one number on both. Delete the Business app account for that number first to release it.
Will I lose my WhatsApp chat history when I migrate?
Yes. History stays on the phone and does not transfer to the API. Export anything contractual or important before you start, because afterwards the app will not open on that number.
How long is my number offline during migration?
In practice under an hour: the risk window runs from deleting the Business app account to completing embedded signup and verification. Pick a quiet time of day and have your templates written in advance.
Do my message templates carry over from another provider?
Templates live on your WhatsApp Business Account rather than with a platform, so they generally survive a move between providers. Flows do not — no two builders share a format, so complex automations are a rebuild.
Does migrating reset my messaging limits?
You start at the standard new-number tier of 1,000 unique customers in a rolling 24 hours, rising to 10,000 and 100,000 with volume and quality. Reputation from the free app does not carry over, because the app had no tier.