WhatsApp API Error Codes & Troubleshooting.
Standard status codes, response payloads, common failure triggers, and recommended resolution steps for developers.
One or more mandatory payload parameters are missing or malformed.
Ensure 'service', 'text', 'api_key', and 'whatsaap_number' are present in the JSON body.
The user's WhatsApp instance is in 'STOPPED', 'SCAN_QR_CODE', or inactive state.
Navigate to Console Dashboard and scan the QR code to ensure live status is 'WORKING'.
Prepaid wallet credit is lower than the service fee (₹0.25 for OTP, ₹0.45 for Message).
Top up your wallet via Dashboard 'Add Money' with a minimum of ₹50.
The passed api_key header or body parameter does not match any registered key.
Verify that the API key is active in Dashboard > API Keys.
Rate limiter threshold exceeded for your IP address or key.
Implement exponential backoff or space requests with a delay (at least 2000ms for bulk).
Underlying session runtime connection error.
Restart your session from the Wapix Dashboard.