---
description: Learn how to migrate your phone number from other BSPs to respond.io WhatsApp Business API.
title: Phone Number Migration to respond.io WhatsApp Business Platform (API)
image: https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0
---

[New🌍 WhatsApp API Calling is now available globally! Start making calls with respond.io today. Learn more![arrow-icon](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2Fe43213a7a9314673bd8d2060c25f9b87)](/whatsapp-business-calling-api)

Help me with... ⌘ 

1. [All Collections >](/help)
2. [ Channels >](/help/channels)
3. [ WhatsApp >](/help/whatsapp)
4. Phone Number Migration to respond.io WhatsApp Business Platform (API)

# Phone Number Migration to respond.io WhatsApp Business Platform (API)

![Avatar](https://assets2-proxy.respond.io/ph8r57dk1q9w/4GvzCieeTBRY4TRJUbIr4y/b92428e6b049d23f546269180534f7ea/Ryan_Tan_Avatar.svg)

Joshua Lim

· 22 Oct 2025

6 min read

## Benefits of migrating to respond.io WhatsApp Business Platform (API)

Migrating to respond.io's WhatsApp Business Platform (API) provides businesses with a wide range of benefits such as:

* Lower costs and transparent charges with our intuitive [WhatsApp Fees module](https://respond.io/help/organization-settings/whatsapp-fees).
* Support for the latest features of WhatsApp Business Platform (API).
* Faster message delivery through respond.io BSP than those sent through an on-premise solution.
* Reliable service and connection with minimal interruptions to your WhatsApp Activities.
* Zero Impact on your existing workflows and broadcasts upon successfully migrating to respond.io.

## What will be migrated?

| Migrated                                                 | Not Migrated                                           |
| -------------------------------------------------------- | ------------------------------------------------------ |
| ✅ Display name                                           | ❌ Low-quality, rejected, or pending message templates. |
| ✅ Phone Number Quality rating                            |                                                        |
| ✅ Messaging limits                                       |                                                        |
| ✅ Official Business Account status (Blue Tick)           |                                                        |
| ✅ Any high-quality message templates previously approved |                                                        |

## Migration pre-requisites

To ensure a successful migration, read and understand the following pre-requisites before migrating to respond.io WhatsApp Business Platform (API):

* You need a Meta Business Manager account with an [admin access role](https://www.facebook.com/business/help/623924618023072?id=2190812977867143) to sign up for a WhatsApp Business Account (WABA) under respond. Additionally, Your business must be verified, and your phone number display name and WABA must be approved (name\_status is APPROVED). Business phone numbers with pending display name change requests cannot be migrated.
* Your phone number display name must be approved
* You need to [turn off your WhatsApp number two-step verification](https://respond.io/help/whatsapp/turn-off-whatsapp-number-two-step-verification) in your [Meta Business Manager](https://business.facebook.com/settings/whatsapp-business-accounts). If you've gone through the classic sign-up method, contact your current BSP to turn off your two-step verification for you.
* Ensure that your respond.io WhatsApp Business Account have sufficient phone number slots to accommodate the phone number you’ll be migrating from. If not, consider [removing a phone number or verifying your business](https://respond.io/help/whatsapp/phone-number-migration-to-respond-whatsapp-business-api#i%5Fam%5Freceiving%5Fan%5Ferror%5Fsaying%5Fphone%5Fnumbers%5Fcount%5Fexceeded%5Flimit%5Fper%5Fbusiness%5Fyou%5Fhave%5Falready%5Flinked%5Fthe%5Fmaximum%5Fnumber%5Fof%5Fphone%5Fnumbers%5Fallowed%5Ffor%5Fthis%5Fbusiness%5Faccount%5Fwhat%5Fshould%5Fi%5Fdo) to have more phone number slots.
* You must have access to the phone number you want to migrate in order to receive a One-Time Password (OTP) via SMS or phone call.
* [Register the phone number](https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers#registering-phone-numbers) to get it through the Interactive Voice Response (IVR) system if required.
* Allow pop-ups on your browser. Here’s a [guide if you are using Google Chrome Browser](https://support.google.com/chrome/answer/95472?hl=en&co=GENIE.Platform%3DDesktop).
* You have to use the same business account in your Meta Business Manager that is currently linked to your WhatsApp BSP account.

> Ensure your WABA/MBM currency is set to **USD**. This step is crucial to avoid issues with sending business-initiated conversations despite having sufficient credits.

## Migration limitations

* **Test Numbers**: Test business phone numbers issued by WhatsApp cannot be migrated.
* **Cloud API Only**: Migrated business phone numbers can only be registered for use with the Cloud API, not the On-Premises API.
* **Message History and Media**: Message history and uploaded media will not be migrated if the source WABA is on On-Premises API.
* **Template Quality Ratings**: Migrated templates will start with an UNKNOWN rating, updated after 24 hours if sufficient data is available.

## Steps to migrate to respond.io WhatsApp Business Platform (API)

Watch the video below for a step-by-step guide on How to Migrate WhatsApp Business Platform (API) to respond.io BSP.

### Step 1: Begin phone number migration

1. Go to **Workspace Settings** \> **Channels** \> navigate to WhatsApp Business Platform (API) > click **Connect**  
![](https://assets2-proxy.respond.io/ph8r57dk1q9w/IOL9x20fwT5cF0ARiLMAK/c846da4d9b8f1f9ed35e77ede73cd939/image.png?fm=jpg&q=80&w=640)
2. Select the relevant option if you are connecting a new Channel or connecting an existing WhatsApp Business Platform (API) account. Then, click **Get Started.**

> For new WhatsApp Business Platform (API) account, you can follow along the connection flow or follow [this guide](https://respond.io/help/whatsapp/whatsapp-api-quick-start#how%5Fto%5Fsign%5Fup%5Ffor%5Fwhats%5Fapp%5Fbusiness%5Fplatform%5Fapi).

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/hsJahPj22WiN85ba7WLYZ/4aa8171fb94b10a4802d2051fd835b7c/image.png?fm=jpg&q=80&w=640) 

3\. Select whether you are connecting an exisiting account with respond.io or another BSP. Then, click **Next**.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/6ObhqIiGXu9pLDJagf6sq1/6edd05cac24dd8b7577310ecbf9aa96e/image.png?fm=jpg&q=80&w=640) 

4\. Click on **Migrate With Facebook**

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/2XwfWr0Z1rMBUbTKhJJmuF/c8fb1a71cc181e27b1fcc5c6b76bab34/image.png?fm=jpg&q=80&w=640) 

5\. Login with your Facebook account to grant permissions

6\. Click **Get Started** to proceed

> Granting permissions will allow respond.io to manage your WhatsApp Business Account and billing.

### Step 2: Connect your Facebook Account and Select or Create a New WABA

1. Click on the **Connect with Facebook** button
2. Sign in to your Facebook account
3. Create or select an existing WhatsApp Business Account (WABA) registered under respond.io.
4. Fill in your business information

> It is advisable for you to create a new WhatsApp business account to avoid potential issues after the migration.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/4opyq0logdSEndTyhQZGIS/4c95c8e7091ba1fc8fde50a943db9895/migration.gif?w=480&fm=avif) 

### Step 3: Enter the Phone Number

1. Enter the phone number ([in the E164 format](https://en.wikipedia.org/wiki/E.164#Numbering%5Fformats)) along with the country code in the input field.
2. Select your preferred method to receive the one-time password (OTP) - SMS or a phone call.

> Users using a virtual phone number must have access to the virtual phone number to receive the One-Time Password (OTP) via an SMS or a phone call.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/4eLMUUc1IdtfAGk808yagm/e86db1e6f4aac87cc12219a5dd096fa9/image.png?fm=jpg&q=80&w=640) 

### Step 4: Verify ownership of the phone number

1. Enter the one-time password (OTP) you received via SMS or a phone call to verify your phone number.
2. Then, click **Next** \> **Finish**
![](https://assets2-proxy.respond.io/ph8r57dk1q9w/4LhBgQtxD1Zdc2pweybAmv/30fea7a0c339f29769aad541f2bacc17/verify.gif?w=480&fm=avif) 

### Step 5: Select the Channel you are migrating from

1. Select the Channel you are migrating from
2. Click **Save**
![](https://assets2-proxy.respond.io/ph8r57dk1q9w/11wbuV3bSZi0v6EZjVXvGR/b61fd14ce9e3c9156e6708cd57518bc7/migrated.png?fm=jpg&q=80&w=640) 

> Congratulations on migrating your WhatsApp Business account to respond.io!

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1bmC0ngl0TBjsVF23Y00Fs/a132ec4c282520a987b2657b49e24691/image.png?fm=jpg&q=80&w=640) 

**What happens next:**

* If no previous Channels exist, a new Channel will be created for you.
* You can now [configure the Channel](https://respond.io/help/whatsapp/whatsapp-business-api-quick-start#channel%5Fconfiguration), access the WhatsApp Fees Module to manage your balance and send and receive messages.
* Your broadcasts and Workflows that were previously set up for your previous WhatsApp Channel are now automatically reconfigured to work with your newly connected respond.io WhatsApp Business Platform (API) Channel.

> To prevent future charges, cancel your subscription with your old WhatsApp Business Solution Provider (BSP) once you've successfully migrated to respond.io's WhatsApp Business Platform (API).

## FAQ and Troubleshooting

### Can I migrate from any other WhatsApp Business Service Provider?

Yes, you can migrate your phone number to respond.io WhatsApp Business Platform (API) from any other WhatsApp Business Service Provider, regardless of whether it is listed as a WhatsApp Channel on respond.io's platform. There are 2 ways you can start the migration process:

* Click on [this link](https://app.respond.io/settings/channels/migrate/whatsapp) to start the migration process.
* Go to your **Workspace Settings** \> **Channels** \> **\+ Add Channel** \> **WhatsApp Business Platform (API)** \> **Next** \> **migrate now**
![](https://assets2-proxy.respond.io/ph8r57dk1q9w/48pTcEO6tNkGFO48dKbE96/e7a67163596b3d0a097ed65e901d6ff0/migratio.png?fm=jpg&q=80&w=640) 

> If you are having trouble with migration, please [contact our support](https://respond.io/contact).

### Will the conversation window remain open after I migrate my phone number?

Yes, you can retain any ongoing conversation windows even after migrating your phone number to the respond.io WhatsApp Business Platform (API). This means that if you were previously engaged in a conversation with someone using previous WhatsApp Channels, you will still have access to that conversation when you switch to respond.io. It's important to note that the conversation window timer will not be reset during the migration, so any remaining time will still be applicable.

### How long will the migration process take?

Our platform migration flow should allow for the completion of the process within 5 minutes.

### Is there any downtime during the migration process?

No, during the migration process, there will be no downtime, and any messages sent to your phone number will be received once the migration is completed.

### What is the impact of migration on WhatsApp Billing?

Messages sent before the migration will be charged to the previous WhatsApp provider, while messages sent after the migration will be charged to respond.io. Any messages sent that are not delivered before the migration will still be charged to the previous provider when they are delivered. In cases where overcharges are identified, the overcharged amount will be refunded to your wallet at the end of the billing cycle. Billing for all conversations that occur under respond.io WhatsApp Business Platform (API) Channel can be managed on your platform’s organization settings under [WhatsApp Fees](https://respond.io/help/organization-settings/whatsapp-fees).

### I have created workflows and broadcasts using my previous WhatsApp BSP Channel, will they still work after migrating?

Yes, your broadcasts and workflows that were previously set up for your WhatsApp BSP Channel are now automatically reconfigured to work with your newly connected respond.io WhatsApp Business Platform (API) Channel.

### Where can I find my Channel ID?

Go to **Settings** \> **Channels** \> Navigate to your Channel

The **Channel ID** is displayed below your Channel Name.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1smATno7XmnQgksmtZSAhQ/c94c6ab82e130af65dbb0ee04b24ad2b/untitled.png?fm=jpg&q=80&w=640) 

### I am receiving an error saying “Phone numbers count exceeded limit per business. You have already linked the maximum number of phone numbers allowed for this business account.” What should I do?

It's possible that you've added too many phone numbers to your WhatsApp Business Account, surpassing the limit. To rectify this, you can [delete a phone number from a WABA](https://developers.facebook.com/docs/whatsapp/phone-numbers#delete-phone-number-from-a-waba). If you wish to avoid deleting any phone numbers, you may want to consider verifying your business to increase your phone number slots limit. Learn more about [Meta business verification here](https://www.facebook.com/business/help/2058515294227817?id=180505742745347).

### I am receiving an error saying “Cannot migrate phone number. Please add this phone number in your WhatsApp account.” What should I do?

You are encountering this error because the number you entered not being registered under any WhatsApp account. Please make sure you input the correct number you wish to migrate. If the number is not registered, you may consider registering it directly with respond.io's WhatsApp Business Platform (API) by referring to this [guide](https://respond.io/help/whatsapp/whatsapp-api-quick-start).

### I am receiving an error saying “Invalid number of WABA accounts shared.” What should I do?

You are encountering this error because you have selected two or more WABAs to migrate to, whereas the migration process only allows for migration to a single WABA. To resolve this issue, reconnect with Facebook and close the first Dialog using META. Then, in the second Dialog, click on 'Edit settings' and ensure that you have selected only one WABA - the one you intended to migrate to or the one you created.

### I am receiving an error saying “Unknown Error. Please contact support.” What should I do?

If you've encountered and resolved any issues, it's possible that you received this error due to attempting another migration too quickly. To resolve this, we recommend waiting for at least a day before attempting to migrate again.

### I am receiving an error saying “Code couldn't be sent. Please try again in some time" when attempting to obtain the OTP code. What should I do?

We recommend to retry again after an hour. If the issue persists, [contact support](https://respond.io/contact) for assistance.

### How can I revoke rocketbots.io credit line in MBM when off-boarding from respond.io to a different BSP?

To revoke the rocketbots.io credit line in MBM when transitioning from Respond.io to a different Business Solution Provider (BSP), follow these steps:

1. Delete the Channel: Deleting the channel associated with respond.io from the platform initiates the off-boarding process.
2. Deregister the Credit Line: Upon deleting the channel, go to your MBM to deregister and revoke the credit line associated with rocketbots.io, provided that no other number under the same business remains connected in the platform.

Please note that simply deleting the channel and deregistering will not revoke the credit line. The credit line will be revoked under the following scenarios:

* A channel is deleted, and there are no more channels connected.
* The WABA’s usage falls below the threshold of USD -10.

> If you are deleting a WABA channel with a positive balance and wish to migrate to a different BSP using the same number, it is recommended to create a new WABA with the BSP and migrate your number to that new WABA and BSP. This ensures a smooth transition and revokes the credit line associated with rocketbots.io.

### What happens if I fail multiple migration attempts from my current BSP to respond.io?

If you experience 10 failed migration attempts from your current Business Service Provider (BSP) to respond.io, Meta enforces a 72-hour waiting period before you can attempt to connect your number again. This waiting period can leave you unable to connect your number if you have already canceled with your previous provider.

To avoid this, [ensure that all pre-requisites are met](https://respond.io/help/whatsapp/phone-number-migration-to-respond-whatsapp-business-api#migration%5Fpre%5Frequisites) before initiating the migration process. If you encounter issues, please [contact our support team](https://respond.io/contact) for assistance to help you through the process and prevent multiple failed attempts.

Share this article

[![Telegram](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F44daca77a4844f0c8fd29040ddeba057?width=22)](https://api.whatsapp.com/send?text=https://respond.io/help/whatsapp/phone-number-migration-to-respond-whatsapp-business-api)[![Facebook](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/fff57eeb01160bc604392f519b4f3461ca16f0fa1b6a587b20b142cdf1ad0ba7?placeholderIfAbsent=true&width=22)](https://www.facebook.com/sharer/sharer.php?u=https://respond.io/help/whatsapp/phone-number-migration-to-respond-whatsapp-business-api)[![Linkedin](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/7aaf8d87b5410844d83e06a4ed663e4f551b8c5ef51dbb20a8ff064a1eed9a0f?placeholderIfAbsent=true&width=22)](https://www.linkedin.com/sharing/share-offsite/?url=https://respond.io/help/whatsapp/phone-number-migration-to-respond-whatsapp-business-api)[![Twitter](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4e03e02422a94e8eab9b8b41457c2371?width=22)](http://twitter.com/share?url=https://respond.io/help/whatsapp/phone-number-migration-to-respond-whatsapp-business-api)

## 

Related articles 👩‍💻

* [WhatsApp Business Platform (API) Quick StartGet a WhatsApp Business API account fast to start chatting with your customers. ](/help/whatsapp/whatsapp-api-quick-start)
* [WhatsApp Business App Quick Start (WhatsApp Coexistence)Learn how to connect the WhatsApp Business App to respond.io for seamless messaging and automation. ](/help/whatsapp/whatsapp-coexistence)
* [Getting Ready for Inbound ConversationsLearn about conversation windows, sending message templates and setting up a simple entry point to manage WhatsApp messages from your customers. ](/help/whatsapp/getting-ready-for-inbound-conversations)
* [Getting Ready for Promotional MessagingLearn how to broadcast promotional messages using WhatsApp message templates. ](/help/whatsapp/getting-ready-for-promotional-messaging)
* [WhatsApp Official Business Account (Blue Tick)Learn how to get a WhatsApp Official Business Account. ](/help/whatsapp/whatsapp-official-business-account-blue-tick)

Can't find what you're looking for? 🔎

[Contact Support](/contact-us)

2025-12-05T03:58:04.817Z

help

```json
[{"@context":"https://schema.org","@type":"TechArticle","articleBody":"Learn how to migrate your phone number from other BSPs to respond.io WhatsApp Business API.","author":{"@type":"Person","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/4GvzCieeTBRY4TRJUbIr4y/b92428e6b049d23f546269180534f7ea/Ryan_Tan_Avatar.svg","name":"Joshua Lim","url":"https://respond.io/author"},"dateCreated":"2025-02-04T02:20:32.000Z","dateModified":"2025-10-22T09:57:18.116Z","datePublished":"2025-02-04T02:20:32.000Z","headline":"Phone Number Migration to respond.io WhatsApp Business Platform (API)","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/hsJahPj22WiN85ba7WLYZ/4aa8171fb94b10a4802d2051fd835b7c/image.png","mainEntityOfPage":"https://respond.io/help/whatsapp","publisher":{"@type":"Organization","logo":"https://respond.io/favicon/favicon.svg","name":"respondio"},"thumbnailUrl":"https://assets2-proxy.respond.io/ph8r57dk1q9w/hsJahPj22WiN85ba7WLYZ/4aa8171fb94b10a4802d2051fd835b7c/image.png","url":"https://respond.io/help/whatsapp/phone-number-migration-to-respond-whatsapp-business-api"},{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Help","item":"https://respond.io/help","position":1},{"@type":"ListItem","name":"Channels","item":"https://respond.io/help/channels","position":2},{"@type":"ListItem","name":"WhatsApp","item":"https://respond.io/help/whatsapp","position":3},{"@type":"ListItem","name":"Phone Number Migration to respond.io WhatsApp Business Platform (API)","item":"https://respond.io/help/whatsapp/phone-number-migration-to-respond-whatsapp-business-api","position":4}]}]
```
