⚠️ WhatsApp Error Codes

WhatsApp API Error Codes — Complete Reference Guide

Encountered an error with WhatsApp API? Use this guide to understand common error codes, their causes, and step-by-step solutions to resolve them quickly.

Error Reference

Common WhatsApp API Error Codes & Solutions

Here are the most common error codes you may encounter when using Postabi's WhatsApp API, along with their causes and solutions.

401

Unauthorized — Invalid API Key

Cause: Missing or invalid API key in the Authorization header. Solution: Verify your API key in the Postabi dashboard and ensure it is correctly included in requests.

400

Bad Request — Invalid Parameters

Cause: Missing required fields or invalid phone number format. Solution: Ensure "to" field includes country code without + (e.g., 923001234567) and all required fields are present.

429

Rate Limit Exceeded

Cause: Sending messages faster than the allowed rate. Solution: Implement exponential backoff. Max 10 requests/second for Web API. Reduce your sending speed.

503

Service Unavailable — Phone Disconnected

Cause: Your WhatsApp phone is offline. Solution: Check that the phone connected to Web API has active internet. Re-scan QR code if needed.

💬 Get Error Help — Contact Support

Error Codes Table

Complete Error Code Reference

CodeDescription

401Invalid or missing API key

400Invalid request parameters

429Rate limit exceeded

503Phone disconnected

404Message ID or resource not found

413Message content too large

500Internal server error (contact support)

Troubleshooting

Quick Fixes for Common Issues

📱

Phone Not Connecting

Make sure your phone has stable internet. Open WhatsApp and check if WhatsApp Web is active. Re-scan the QR code from your dashboard.

📤

Messages Not Delivering

Verify the recipient number is correct with country code. Ensure the number has WhatsApp installed. Check if you exceeded rate limits.

🔑

API Key Issues

Regenerate your API key from the Postabi dashboard if it's compromised. Ensure the key is sent in the Authorization header with Bearer prefix.

⚠️

Still Stuck?

WhatsApp us with the error code and details. Our support team resolves most issues within 30 minutes.

💬 Report an Error — WhatsApp Us