> For the complete documentation index, see [llms.txt](https://learn.doubletick.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.doubletick.io/get-started-with-doubletick/migration/api-to-api-migration-guide.md).

# API to API migration guide

Learn how to migrate your WhatsApp API number from another provider to DoubleTick while keeping the same number, WhatsApp Business Account, and messaging limit.

If your WhatsApp number is already on the **WhatsApp Cloud API** with another provider, you can move it to **DoubleTick without changing the number**. You pick your existing number from a list in Meta's signup window, confirm what you're sharing with DoubleTick, and the number connects in a few minutes. You don't need to re-enter your business profile, verify the number with an OTP, or turn off two-step verification.

#### What's covered

* [When API to API migration is required](https://learn.doubletick.io/get-started-with-doubletick/migration/api-to-api-migration-guide.md#when-is-api-to-api-migration-required)
* [Before you start](https://learn.doubletick.io/get-started-with-doubletick/migration/api-to-api-migration-guide.md#before-you-start)
* [Where to start in DoubleTick](https://learn.doubletick.io/get-started-with-doubletick/migration/api-to-api-migration-guide.md#where-to-start-in-doubletick)
* [How to migrate your number to DoubleTick](https://learn.doubletick.io/get-started-with-doubletick/migration/api-to-api-migration-guide.md#how-to-migrate-your-number-to-doubletick)
* [What moves over and what doesn't](https://learn.doubletick.io/get-started-with-doubletick/migration/api-to-api-migration-guide.md#what-moves-over-and-what-doesnt)
* [What to do after migrating](https://learn.doubletick.io/get-started-with-doubletick/migration/api-to-api-migration-guide.md#what-to-do-after-migrating)
* [Key takeaways](https://learn.doubletick.io/get-started-with-doubletick/migration/api-to-api-migration-guide.md#key-takeaways)
* [Frequently asked questions](https://learn.doubletick.io/get-started-with-doubletick/migration/api-to-api-migration-guide.md#frequently-asked-questions)
* [Related articles](https://learn.doubletick.io/get-started-with-doubletick/migration/api-to-api-migration-guide.md#related-articles)

#### When is API to API migration required?

Use this process if:

* Your number is already on the **WhatsApp Cloud API**.
* The number is not on the **WhatsApp Business App** or onboarded as **Coexistence**.
* You want to move your number from another provider (**BSP**) to **DoubleTick**.

#### Before you start

* Make sure you have **admin access** to the Meta Business portfolio that owns the number.
* Open Meta Business Suite, go to **WhatsApp Manager**, then **Phone numbers**. Check that your number shows as **Connected**. This is the number you'll move.
* Allow pop-ups for web.doubletick.io in your browser. Meta's signup window opens as a pop-up, and if pop-ups are blocked, you'll see a **Popups are blocked** message instead.
* Keep your Facebook login handy. Meta may ask you to confirm it's you (with a passkey or SMS code) before the flow continues.

#### Where to start in DoubleTick

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FjvU4pNPqjjrm5tjFcSgl%2FUntitled%20design%20(26)%20(1).gif?alt=media&#x26;token=82ec05c2-0451-4f93-9599-06a92e3e7d27" alt=""><figcaption></figcaption></figure>

* **New DoubleTick account:** Sign up with your phone number and OTP, then verify your email address with the code sent to your inbox. On the **Next Step** page, under **Connect with WhatsApp**, click **Get Started**.

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2F6EofgrITnf3G10JWhaNQ%2FUntitled%20design%20(27)%20(1).gif?alt=media&#x26;token=c61304e8-a95d-4ed6-ada4-9acd089e8b44" alt=""><figcaption></figcaption></figure>

* **Existing DoubleTick account (adding another number):** Go to **Settings**, open **Manage channels**, and click **Add number** in the top-right corner.

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FeFMvFyQNzKGCBELOu4WB%2FUntitled%20design%20(59).gif?alt=media&#x26;token=790ecf90-d5bb-490e-9666-f4906e91ce81" alt=""><figcaption></figcaption></figure>

From here, the steps are the same in both cases.

#### How to migrate your number to DoubleTick

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FFXXt7nSMayMthVUgUVIF%2Fgif_01_choose_onboarding_method.gif?alt=media&amp;token=0c6d7dcf-a295-40ed-a214-11c542dca36e" alt=""><figcaption></figcaption></figure>

**Choose the onboarding method:** \
In the Choose Your Onboarding Method popup, select Connect WhatsApp API number and click Confirm and Proceed. Meta's signup window opens.

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FFHDJZU3ZWTOPGvbjdOMi%2Fgif_02_meta_signup_continue.gif?alt=media&amp;token=5d86a87c-18fe-40dc-ac58-cdc1283adfa0" alt=""><figcaption></figcaption></figure>

**Start the Meta flow:** On the Seamlessly connect your account to DoubleTick.io screen, review the details and click **Continue**.

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FEWzBSwl302iVsX38ES7n%2Fgif_03_select_existing_number.gif?alt=media&amp;token=444732b5-4348-433f-a433-95c5399507e6" alt=""><figcaption></figcaption></figure>

**Select your existing number:** \
On **Add your WhatsApp phone number**, open the **Phone number** dropdown. Numbers already in your Meta Business portfolio show a **Registered** tag. Pick the number you want to move. Don't choose **Enter a new phone number**. The country code and number fill in automatically. Click **Next**.

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FfBbZgbX5KblnooAWS7es%2Fgif_04_business_assets_and_review.gif?alt=media&amp;token=ca16e0e4-7774-4924-8bba-4b5159672ccf" alt=""><figcaption></figcaption></figure>

**Check your business assets:** On **Select the business assets to share with DoubleTick**, your **Business portfolio** and **WhatsApp account** are already selected. Make sure they're the same portfolio and WhatsApp account your number is on today, then click **Next**.

**Review and confirm:** Meta shows what DoubleTick will get access to: your business, your WhatsApp account, and a messaging account. Click **Confirm**.

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2F4Zo2Bk9JB0z3DDokwkLd%2Fgif_05_connecting_and_finish.gif?alt=media&amp;token=c6a6b281-6e0b-42aa-9674-692e564e5f4b" alt=""><figcaption></figcaption></figure>

**Wait while it connects:** You'll see **Connecting your account**. This takes around 20 to 30 seconds. Don't close the window.

**Finish:** When you see **Your account is connected to DoubleTick.io**, click **Finish**. Meta reviews your business within 24 hours and will reach out only if there's an issue.

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2FONGHqX6nvVqYgMyAPTHa%2Fgif_06_connected_in_doubletick.gif?alt=media&amp;token=0fb410dd-004b-4115-83a4-a0245b57f271" alt=""><figcaption></figcaption></figure>

**Confirm in DoubleTick:** \
Back in DoubleTick, a **Connected** popup confirms your WhatsApp number was added successfully. Click **Continue**. Your dashboard now shows the number under **WhatsApp account overview** with an **Active** status. Once your number is successfully onboarded on DoubleTick, your previous provider's access **ends automatically**.

{% hint style="info" %}
On the final Meta screen, you may see a **Review conversation routing** notice. It means your existing routing settings may not work as expected now that DoubleTick is added. If you had routing set up with your previous provider, review it in your Meta Business settings.
{% endhint %}

#### What moves over and what doesn't

* **Phone number and display name:** Stay the same. Customers see the same name as before.
* **WhatsApp Business Account:** Your number stays in the same WABA. Meta adds a new messaging account to it, named after your portfolio with "DoubleTick.io" at the end. You can see it in Meta Business Suite under **Settings**, then **Accounts**, then **Messaging accounts**.
* **Messaging limit:** Carries over, since it's the same number. You can check it in WhatsApp Manager under **Messaging limits**.
* **Templates:** Only high-quality templates move over. Others need to be created again in DoubleTick.
* **Blue tick:** Usually carries over. If it doesn't, keep your WABA active for 30 days and then apply for it again.
* **Chat history:** Doesn't move. Your past conversations stay with your previous provider.

{% hint style="warning" %}
If your blue tick doesn't carry over, you can apply for it again after your WABA has been active on DoubleTick for 30 days. Meta reviews the request and approves it, the same way as your first application.
{% endhint %}

#### What to do after migrating

<figure><img src="https://2303112206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F53n17VnOICC1LtDqlENV%2Fuploads%2F5R46O8I2RIwxVN7mHomc%2Fgif_07_campaigns_templates_sync.gif?alt=media&amp;token=8fb83a16-1fca-4805-a890-d11dcb3acbc2" alt=""><figcaption></figcaption></figure>

* **Sync your templates:** Go to **Campaigns**, then **Templates**, and click the sync icon (**Sync templates with Meta**). If a template you need is missing, create it again with **New Template** before you send a broadcast.
* **Send a test message:** Send a quick "Hi" to your number and check that it arrives in DoubleTick. On your phone, check that your display name and blue tick look right.
* **Update your channel profile:** Go to **Settings**, then **Manage channels**. Click the three dots next to your number and select **Update Channel profile** to edit details like the vertical, email, and website.

#### Key takeaways

* You can move your **Cloud API number** from another provider to DoubleTick and **keep the same number**.
* You don't need to turn off **two-step verification** before you start.
* Allow **pop-ups** in your browser so Meta's signup window can open.
* In Meta's flow, pick your existing number from the dropdown (it shows as **Registered**). You don't re-enter your business profile or verify with an OTP.
* Your number, display name, WABA, and messaging limit **stay the same**, and Meta adds a DoubleTick messaging account to your WABA.
* Your previous provider's access **ends** once the number is onboarded on DoubleTick.
* Only **high-quality templates** move over. Sync your templates and recreate any missing ones before broadcasting.
* **Chat history doesn't move.** If your blue tick doesn't carry over, you can apply again after 30 days.

#### Frequently asked questions

<details>

<summary>Do I need to disable two-step verification before migrating?</summary>

No. Two-step verification doesn't need to be turned off, so you can start the migration right away.

</details>

<details>

<summary>Will I keep the same phone number?</summary>

Yes. Only your provider changes. Your number stays the same.

</details>

<details>

<summary>Do I need to enter my display name, category, or an OTP?</summary>

No. You just select your existing number from the dropdown. Your business profile stays as it is, and the number doesn't need OTP verification.

</details>

<details>

<summary>What happens to my previous provider's access?</summary>

It ends automatically once your number is successfully onboarded on DoubleTick.

</details>

<details>

<summary>Will my messaging limit stay the same?</summary>

Yes. Since you're moving the same number, your messaging limit carries over. You can check it in WhatsApp Manager under **Messaging limits**.

</details>

<details>

<summary>Will my templates move to DoubleTick?</summary>

Only high-quality templates move over. After migrating, go to **Campaigns**, then **Templates**, sync your templates, and create any missing ones again before you send a broadcast.

</details>

<details>

<summary>Will my blue tick move over?</summary>

In most cases, yes. If it doesn't, keep your WABA active for 30 days and then apply for the blue tick again. Meta reviews and approves it, the same way as your first application.

</details>

<details>

<summary>My number isn't showing in the dropdown. What should I do?</summary>

Make sure you're logged in to the Facebook account that has admin access to the Meta Business portfolio that owns the number. Only numbers in that portfolio show up with the **Registered** tag.

</details>

<details>

<summary>I see a "Popups are blocked" message. What now?</summary>

Allow pop-ups for web.doubletick.io in your browser settings, then click **Get Started** again.

</details>

<details>

<summary>Does my chat history move to DoubleTick?</summary>

No. Chat history doesn't move during this process.

</details>

<details>

<summary>Is API to API migration reversible?</summary>

No. Once it's done, it can't be undone. Make sure you understand the impact before you start.

</details>

#### Related articles

{% content-ref url="/spaces/53n17VnOICC1LtDqlENV/pages/YHQxgankK6roH5spjXmg" %}
[How to disable two-step verification for your WhatsApp number](https://learn.doubletick.io/meta-business-setup/two-factor-authentication/how-to-disable-two-step-verification-for-your-whatsapp-number.md)
{% endcontent-ref %}

{% content-ref url="/spaces/53n17VnOICC1LtDqlENV/pages/QQZiCy9UeP3sZoy48h5g" %}
[How to change your display name](https://learn.doubletick.io/meta-business-setup/display-name/how-to-change-your-display-name.md)
{% endcontent-ref %}

{% content-ref url="/spaces/53n17VnOICC1LtDqlENV/pages/Iuf8lM8HfYZrikuGEjus" %}
[How to Manage Channels](https://learn.doubletick.io/settings/how-to-manage-channels.md)
{% endcontent-ref %}


---

# 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://learn.doubletick.io/get-started-with-doubletick/migration/api-to-api-migration-guide.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.
