Error "401. Need channel authorization"

An error occurs when attempting to make a request via the API.

{
  "error": {
    "code": 401,
    "message": "need channel authorization for send message"
  }
}

The error means that the channel (instance) is currently not authorized, or that WhatsApp has terminated the active session. What to do: Open the Dashboard and check the channel status. If the status is QR, perform reconnection (reconnect / re-authorize).

The most common reason for a session disconnection is inactivity of the primary phone. WhatsApp requires logging in on the primary device at least once every 14 days; otherwise, all linked devices, including the API channel, are disconnected. To avoid this, open WhatsApp on your phone at least once every 14 days.

Less frequently, WhatsApp may terminate a session due to protective mechanisms:

  • unusual or mass activity;

  • connecting a new number to the API without proper warm-up.

Last updated

Was this helpful?