Skip to main content
Every error response has the same shape:
Branch on code and sub_code, never on message: the text may change, the codes don’t. sub_code is always present on CHANNEL_ERROR, and on other codes only in the cases listed under Sub-codes. When it is absent, handle the error on code alone; treat an unknown sub_code the same way.

Handling errors

WhatsApp only: NOT_CONNECTED means the connection to WhatsApp dropped and is being reopened automatically. Retry later and do not re-link the number. No webhook is sent when the connection drops or comes back; re-link only when you receive a disconnection event.

Codes

Examples

Sub-codes