OnPrem to CloudAPI migration

On October 23, 2025, the final supported version of the On-Premise API will expire. Messages sent to or from business numbers with On-Premises API will not be delivered.

Refer to Meta's official On-Premise sunset document for more information.

Here is how to move from On-Premise API to CloudAPI:

1

Get Familiar with Cloud API

• OnPremise API uses old endpoint https://waba.360dialog.io

• Cloud API uses new endpoint https://waba-v2.360dialog.io/messages

More details about Cloud API:

Architecture and SecurityThe Basics (Overview)Messaging API

2

Change Hosting Type to Cloud API

We recommend trying to migrate a test number to Cloud API before migrating all numbers.

To move an existing number to Cloud API, you can use the 360Dialog Hub interface. From there, you can easily switch hosting types.

The migration may temporarily take down the number for a few minutes.

Hosting type Change

3

After the migration

• Make sure you are calling the correct endpoint: https://waba-v2.360dialog.io/messages

• Make sure you are using the most recently generated API KEY. Old API KEYs will not work on the Cloud API. It is recommended that you generate another API key after the migration.

  • If you generate a new API Key, make sure to reset your webhook again using the newly generated key.

• Use the WABA Webhook endpoint to configure a new Webhook for all Cloud numbers in this WABA. If you don't do so, the Webhook previously set for the On-premise phone number will be used.

If you encounter any issues, please contact our Support Team.