> For the complete documentation index, see [llms.txt](https://docs.360dialog.com/partner/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.360dialog.com/partner/partner-hub/migrating-phone-numbers/migrate-a-phone-number-to-a-new-waba.md).

# Migrate a phone number to a new WABA

This document explains how to migrate a phone number from one WABA (source WABA) to another (destination WABA) with 360dialog.

## Migration checklist

* [x] Ensure the number can receive and verify a 6-digit PIN via SMS or voice call, and that it can accept international calls.
* [x] Access to the Meta Business Portfolio.
* [x] The Meta Business Account is verified. 
* [x] The existing WhatsApp Business Account (WABA) must be approved. 
* [x] The Display Name is approved. 
* [x] The existing WABA must have a valid payment method attached (in Payment Settings). 
* [x] Two-Factor Verification (2FA) [must be disabled](broken://pages/JLongHgCVUgCCpDUWHjI) for the number. 
* [x] The business website must be live and accessible. Meta may verify the website listed in Meta Business Manager **> Business Info**, and if it is incorrect or inactive, the account could be taken offline following the number migration.
* [x] 🇧🇷 Extra step for Brazilian numbers - Check the current WhatsApp profile to see if the number includes the extra “9.” Use the same format when migrating. 

***

## **How to migrate a phone number to a new WABA**

{% stepper %}
{% step %}

### Access WABA Management App

360dialog Hub > **Manage WhatsApp Business Account**<br>
{% endstep %}

{% step %}

### Click Migrate Number

Locate the WhatsApp Business Account and click Migrate Number toggle.

<figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2FIpQLI8ZPCr0354TO9urP%2Fmigrate_number__.PNG?alt=media&amp;token=6439897e-fd8b-48fa-aa0d-ccd8ceb14a00" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Migrate number between WABAs

Select the first option: Migrate number between WABAs

<figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2FZz5lfWc6Yebz65afNMpO%2Fmigrate_options.PNG?alt=media&amp;token=3d5d5fb7-b03d-4f55-99eb-e4ee66a57e38" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}

### Login to the Meta Portfolio

If the Business Owner is not already logged in, they will be prompted to sign in to the Meta Business Portfolio.<br>
{% endstep %}

{% step %}

### Create a new WhatsApp Business Profile

<div align="left"><figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2F143VlVFQrsRyYszPSBdR%2FScreenshot%202023-07-26%20at%2000.24.33.png?alt=media&amp;token=c731a092-1595-47b1-bde4-fbde48489aab" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
**Pro Tip**\
Use clear and distinct WABA names to minimize errors. Note the existing WABA ID and name before creating a new one to ensure easy differentiation during the migration process.
{% endhint %}

{% endstep %}

{% step %}

### Complete the required fields

Complete all the required fields for the new (destination) WABA.
{% endstep %}

{% step %}

<div align="left"><figure><img src="https://2248475362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuyAl2S0lSHJaNDXJHo7A%2Fuploads%2FIISCAUBkSDgVuFzKbjjl%2FScreenshot%202023-07-25%20at%2023.40.01.png?alt=media&amp;token=cb8bb2ad-45e2-4be2-8c2d-9a2803ff264a" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Finish the Migration process

Using the Embedded Signup flow, follow the steps to the final screen to register the number to the new (destination) WABA.&#x20;

After the migration is complete, verify the transfer by checking the number’s status in its source WABA within WhatsApp Business Manager. If the status shows as “transferred,” the migration was successful.
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.360dialog.com/partner/partner-hub/migrating-phone-numbers/migrate-a-phone-number-to-a-new-waba.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.