WABA Common Error Codes

Comprehensive guide to troubleshooting WhatsApp Business API errors

131026

Message Undeliverable

HTTP Status Code: 400

Description

Unable to deliver message. This error occurs when there are issues with the recipient's WhatsApp account or configuration.

Possible Reasons

The recipient phone number is not a WhatsApp phone number The number provided is not registered with WhatsApp
Sending authentication template to Indian numbers (+91) Authentication templates cannot be sent to WhatsApp users in India
Recipient has not accepted Terms of Service User needs to accept latest WhatsApp Terms and Privacy Policy
Outdated WhatsApp version Recipient must use minimum versions:
• Android: 2.21.15.15
• iOS: 2.21.170.4
• KaiOS: 2.2130.10
• Web: 2.2132.6
Marketing template limits exceeded Message not delivered to maintain high-quality user experience

Possible Solutions

Verify Phone Number

Ask the user to confirm they can send messages to your WhatsApp business number using a non-WhatsApp communication method.

Accept Terms of Service

User should check Settings > Help or Settings > Application information to accept latest terms/policies.

Update WhatsApp

Ensure the recipient updates to the latest version of WhatsApp client.

Check Template Limits

Review and adhere to per-user marketing template message limits.

400

Bad Request

HTTP Status Code: 400

Description

This error occurs when there are issues with the request parameters or recipient configuration that prevent message delivery.

Possible Reasons

Invalid WhatsApp number The recipient phone number is not a valid WhatsApp phone number
Recipient blocked your business The recipient has added your business number to their blocked list
Terms of Service not accepted Recipient has not accepted WhatsApp's new Terms of Service and Privacy Policy
Outdated WhatsApp version Recipient using old WhatsApp version; must update to minimum versions:
• Android: 2.21.15.15
• iOS: 2.21.170.4
• KaiOS: 2.2130.10
• Web: 2.2132.6

How to Solve This?

Verify Message Capability

Using non-WhatsApp communication, ask user to confirm they can send messages to your business number.

Check Blocked List

Confirm your business number is not in their blocked list (Settings > Privacy > Blocked contacts).

Accept Terms of Service

User should accept latest Terms of Service in Settings > Help or Settings > Application information.

Update WhatsApp

Ensure recipient updates to the latest version of WhatsApp client.

WABA Language Codes

WhatsApp Business API supports multiple language codes for communication. These language codes are used to specify the language of the message content.

Language	Code	Region
Afrikaans	`af`	South Africa
Albanian	`sq`	Albania
Arabic	`ar`	Middle East
Azerbaijani	`az`	Azerbaijan
Bengali	`bn`	Bangladesh, India
Bulgarian	`bg`	Bulgaria
Catalan	`ca`	Spain
Simplified Chinese (Mainland China)	`zh_CN`	China
Traditional Chinese (Hong Kong)	`zh_HK`	Hong Kong
Traditional Chinese (Taiwan)	`zh_TW`	Taiwan
Croatian	`hr`	Croatia
Czech	`cs`	Czech Republic
Danish	`da`	Denmark
Dutch	`nl`	Netherlands
English	`en`	International
English (United Kingdom)	`en_GB`	United Kingdom
English (United States)	`en_US`	United States
Estonian	`et`	Estonia
Filipino	`fil`	Philippines
Finnish	`fi`	Finland
French	`fr`	France
German	`de`	Germany
Greek	`el`	Greece
Gujarati	`gu`	India
Hausa	`ha`	West Africa
Hebrew	`he`	Israel
Hindi	`hi`	India
Hungarian	`hu`	Hungary
Indonesian	`id`	Indonesia
Irish	`ga`	Ireland
Italian	`it`	Italy
Japanese	`ja`	Japan
Kannada	`kn`	India
Kazakh	`kk`	Kazakhstan
Korean	`ko`	Korea
Lao	`lo`	Laos
Latvian	`lv`	Latvia
Lithuanian	`lt`	Lithuania
Macedonian	`mk`	North Macedonia
Malay	`ms`	Malaysia, Indonesia
Malayalam	`ml`	India
Marathi	`mr`	India
Norwegian	`nb`	Norway
Persian	`fa`	Iran
Polish	`pl`	Poland
Portuguese (Brazil)	`pt_BR`	Brazil
Portuguese (Portugal)	`pt_PT`	Portugal
Punjabi	`pa`	India, Pakistan
Romanian	`ro`	Romania
Russian	`ru`	Russia
Serbian	`sr`	Serbia
Slovak	`sk`	Slovakia
Slovenian	`sl`	Slovenia
Spanish	`es`	International
Spanish (Argentina)	`es_AR`	Argentina
Spanish (Spain)	`es_ES`	Spain
Spanish (Mexico)	`es_MX`	Mexico
Swahili	`sw`	East Africa
Swedish	`sv`	Sweden
Tamil	`ta`	India, Sri Lanka
Telugu	`te`	India
Thai	`th`	Thailand
Turkish	`tr`	Turkey
Ukrainian	`uk`	Ukraine
Urdu	`ur`	Pakistan, India
Uzbek	`uz`	Uzbekistan
Vietnamese	`vi`	Vietnam
Zulu	`zu`	South Africa

Implementation Guide

How to use language codes and handle errors in your WABA implementation

Using Language Codes

Implement multi-language support in your WhatsApp Business API messages using the appropriate language codes.

API Request Example

{
  "messaging_product": "whatsapp",
  "to": "60123456789",
  "type": "template",
  "template": {
    "name": "hello_world",
    "language": {
      "code": "ms"
    },
    "components": [...]
  }
}

Error Handling

Implement proper error handling for common WABA error codes in your application.

Error Handling Example

try {
  const response = await sendWhatsAppMessage(payload);
} catch (error) {
  if (error.code === 131026) {
    // Handle message undeliverable
    handleUndeliverableMessage(error);
  } else if (error.code === 400) {
    // Handle bad request
    handleBadRequest(error);
  }
}

Need Help with WABA Implementation?

Our experts can help you implement WhatsApp Business API with proper error handling and multi-language support

Technical Implementation

Get help with API integration, error handling, and multi-language implementation.

Get Help

Documentation

Access comprehensive documentation and implementation guides.

View Docs

Live Support

Get immediate assistance with WABA error codes and implementation issues.

Live Chat

WABA Common Error Codes & Language Codes