business_account_required — Needs Business app
What the API returns
{
"error": {
"code": "business_account_required",
"message": "This action requires a WhatsApp Business account.",
"request_id": "req_01JRQ8F4X9N2K7YB3C5V6W8H0T"
}
}Every Wapito error is this one envelope. Branch on code, which is stable; message is written for people and can be reworded; details appears only when there is something specific to say; request_id is what to quote to support.
What it means
business_account_required is an HTTP 409 error from the Wapito WhatsApp API: needs Business app. The response message reads “This action requires a WhatsApp Business account.” It is not retryable: the same request fails again until you change it. 2 endpoints can raise it, GET /labels among them.
Why it happens
The linked number is running the consumer WhatsApp app, and the endpoint you called only exists for WhatsApp Business. Business profiles, product catalogues, collections, orders and the coloured labels used to sort chats are all features of the Business app; the consumer app has no such objects to read or write. Switching apps on the phone is a decision for the number's owner, not something an API can do for them.
How to fix business_account_required
Confirm on the phone whether the linked number runs WhatsApp or WhatsApp Business - the two are separate apps.
If the number should be a business line, migrate it to WhatsApp Business on the phone, then relink the channel.
If it must stay a personal number, stop calling the business endpoints and drop the catalogue or labels part of the flow.
Endpoints that raise it
Where you will meet it
- Profile Picture
Feature guide
Retry guidance
Do not retry as sent
The same request fails the same way until something changes: the body, the credential, the recipient or the state of the channel. Keep it off every retry loop, fix the cause above, and send a corrected request once.
Frequently asked questions
Does switching to WhatsApp Business lose my chat history?
Migrating on the same phone normally preserves history, but this is a decision the number's owner makes on their device and is outside the API's control. Back the phone up first. After the switch the channel has to be paired again because the linked device is replaced.
Are labels really Business-only?
Yes. Labels are a WhatsApp Business feature and simply do not exist in the consumer app, so there is nothing for the engine to list or create. If you need tagging on a personal number, keep the tags in your own database and key them by chat id instead.
Related
Try it on your own number
Create a channel, link a WhatsApp number by QR or pairing code, and call the API in a couple of minutes. The Sandbox plan is free and needs no card.