Migration: BSP to CloudAPI

If you want to migrate from an existing Business Service Provider (BSP) to Meta's CloudAPI, without losing your display name, sending limit & approved templates.

Considering you have a Meta Developer account and a Verified Meta Business

Migrated	Not Migrated
Any High quality message templates previously approved	Low quality, rejected, or pending message templates.
Display name	-
Quality rating	-
Messaging limits	-
Official Business Account status	-

Migrating a business phone number from one Solution Partner to...developers.facebook.com

Postman Collection is based on this Offical Guide

BASIC CHECKLIST

• Create Developer App

• Setup Payment Method

• Disable Two-step verification

• Initiate Phone Migration

• Request Phone Pin

• Verify Phone Pin

• Register Phone

Create a Meta Developer App

Please follow the steps enlisted in the below-mentioned article. In case you have already done a valid app, you can choose to skip this step.

Meta CloudAPI - Developer App

Setup Payment Method

Make sure you have a payment method associated with the WABA.

• Business Manager

  • Business Settings

    • Accounts

      • WhatsApp Business Accounts

        • Select the Business Account

        • [ Payment Settings ]

          • [ Add payment method ]

https://business.facebook.com/billing_hub/payment_settings?asset_id=<WABA-ID>&business_id=<Business-ID>

Start the Migration

You can use Terminal or CMD. To make it easy, we have created a Postman Collection.

We have created a quick collection.

Edit the Collection's Variables before running the endpoints.

Disable Two-step verification

You can skip this if your Phone Number already had Two-step verification disabled.

View of WhatsApp Manager showing Two-step verification is already disabled.

Embedded Signup

You will need to access the Meta Business Manager.

• Business Manager

  • Business Settings

    • 1 Accounts

      • 2 WhatsApp Business Accounts

        • 3 Select the Business Account

        • 4 Settings

        • 5 WhatsApp Manager

          • 6 Select the WhatsApp Account

            • 7 Account Tools

            • 8 Phone numbers

            • Settings (Gear Icon)

              • 10 Two-step verification

              • 11 [ Turn off two-step verification ]

                • 11.a Verify the eMail and click [ Ok ]

              • 12 An eMail will be sent to the Business Manager's eMail.

                • 13 Click on the [ TURN OFF TWO-STEP VERIFICATION ]

https://business.facebook.com/wa/manage/phone-numbers/?business_id=<Business-ID>&phone_number=<Phone-Number-ID>&waba_id=<WABA-ID>&childRoute=PHONE_PROFILE%2FRECOVERY

Open WhatsApp Manager of exiting BSP WABA / On-Premise WABA

WhatsApp Overview | Select the WhatsApp Account

Turn Off 'Two-step verification' of exiting BSP WABA / On-Premise WABA

Business Manager's eMail will receive the Link. | Learn more

Confirmation Link

BSP Classic Signup / -or- / Self-Hosted On-Premise

On-Premises API Sunset - Documentation - Meta for DevelopersMeta for Developers

Offical Guide | Disable Two-step verification

Initiate Phone Migration

WABA-ID of the destination WABA

POST https://graph.facebook.com/{{Version}}/{{WABA-ID}}/phone_numbers

To find the ID of a WhatsApp Business Account, go to Business Manager > Business Settings > Accounts > WhatsApp Business Accounts. Find the account you want to use and click on it. A panel opens, with information about the account, including the ID.

Headers

Name	Type	Description
Authorization*	Bearer	Access Token

Request Body

Name	Type	Description
cc*	NUM	Numerical country code for the phone number being registered.
phone_number*	NUM	Phone number being migrated, without the country code or plus symbol (+).
migrate_phone_number*	Boolmen	To migrate a phone number, set this to true.

200: OK The response is the new Phone Number ID

{
  "id": "<Phone-Number-ID>"
}

Meta

Migrating a business phone number from one Solution Partner to...developers.facebook.com

Offical Guide | Step 1: Initiate Phone Migration

Postman

Verify Phone Ownership

Request the Code

Select SMS of VOICE to receive your code

POST https://graph.facebook.com/{{Version}}/{{Phone-Number-ID}}/request_code

Now that you have requested the migration, you need to confirm it by verifying ownership of the phone number.

Headers

Name	Type	Description
Authorization*	Bearer	Access Token

Request Body

Name	Type	Description
code_method*	ENUM	Method of receiving the registration code. Supported values: SMS and VOICE.
language*	ENUM	Language in which you want to receive the registration code. See language codes.

200: OK The PIN will be sent to the number via the selected method. SMS or VOICE

{
    "success": true
}

Meta

Migrating a business phone number from one Solution Partner to...developers.facebook.com

Official Guide | Step 2: Verify Phone Ownership

Postman

Verify the Code

To verify the code received

POST https://graph.facebook.com/{{Version}}/{{Phone-Number-ID}}/verify_code

The code (6-digit pin) received from the previous Request the Code step is to be used to verify the ownership.

Headers

Name	Type	Description
Authorization*	Bearer	Access Token

Request Body

Name	Type	Description
code*	NUM	6-digit registration code received after making the Request the Code call.

200: OK Confirms that the phone ownership is verified

{
    "success": true
}

Meta

Migrating a business phone number from one Solution Partner to...developers.facebook.com

Offical Guide | Scroll to Verify Code section

Postman

Register Phone

Register the Phone Number to your WABA

POST https://graph.facebook.com/{{Version}}/{{Phone-Number-ID}}/register

You need to register the phone number you want to use to send messages.

Headers

Name	Type	Description
Authorization*	Bearer	Access Token

Request Body

Name	Type	Description
messaging_product*	ENUM	Messaging service used. In this case, use "whatsapp".
pin*	NUM	6-digit registration code received after making the Request the Code call.

200: OK

{
  "success": true
}

Meta

Registrationdevelopers.facebook.com

Offical Guide | Register Phone

Postman

Troubleshoot

Verify if App is Subscribed

Make sure your Meta Developer App ID is listed in your WABA.

Postmanwww.postman.com

Get All Subscriptions for a WABA

Override Callback URL

In case you are not receiving messages to your chat interface, you can choose to override the Callback URL.

Override Callback URL | KDCPostman

Override Callback URL