Channel creation
The method is intended to create an instance for WhatsApp API
Create Channel
In order to create channels, you will need an API Token, which is displayed in the partner control panel
The required parameter is projectId. This is a kind of shell inside your account that groups channels.
In your service, you can independently distribute channels by projects. This will help organize channels the way you need.
To get main projectId, you can call API function: GET https://manager.whapi.cloud/projects
Now that we have this parameter, we can create the channel.
A successful response to your request will look like this:
⚠️ Important notice: If you create more than 20 channels within a 30-minute period, you'll receive a "429: Too Many Requests" error until the 30-minute window resets.
This limit helps ensure stable platform operation. Please avoid creating channels excessively. If you require a higher limit, simply contact our support team—we'll gladly assist you.
⚠️ Important notice: The creation and full initialization of a channel may take up to 1.5 minutes. During this time, initial setup is performed, including the creation of the required tables and an automatic database integrity check. We recommend adding a 1.5 minute pause after creating the channel before performing any actions with it.
Channel created but inactive — no trial, no days
When a partner Create channel , the channel is always created successfully—the API returns a 200 response with the channel ID and token.
However, if the 5-day trial period isn't activated for your partner account, the created channel will be inactive. The channel exists, but is inactive until you explicitly switch the mode and allocate days.
To activate the channel, complete both steps sequentially:
Step 1 - Switch the channel mode to "live": Use the "Change Channel Mode" method
Step 2 - Allocate days from your balance: Use the "Extend Channel" method
Update channel webhook
Once you've created your channel (with a 90 second initialization delay), the best next step is to configure it, which means specifying links to your webhook address.
In this way you can immediately receive notifications about the channel status, about the authorization event of the user (i.e. his connection to the channel).
All details about detailed webhook settings can be found in the article: Detailed webhook settings
Of course, you will need the channel token that you received when you created the channel.
Once the QR code is scanned by the user, you will receive a notification, about this event and the connected number:
Last updated