WhatsApp V2 Error Codes for Template APIs

This topic provides information about various error responses related to templates that are you will be receiving as API response:

The topic contains the following sections:

HTTP Status Codes for Templates

The following is list of HTTP status codes for templates:

Error Codes	Description	Retry Required	Action Owner	Resolution
WA200	Success for send message API.	No	NA	NA
RBC001	Incorrect SID or API Key.	No	Customer's Technology team.	Fix the credentials
WA400	Incorrect Payload.	No	Customer's Technology team.	Fix the JSON payload structure as per specifications.
WA401	Unauthorized access.	Yes	Customer's Operations team.	Validate the account configurations and approval status of the number/template. If the issue persists, reach out to the Tata Communications Operations team for further support.
		Yes	Tata Communications Operations team.	Validate the configurations and contact Meta support (if required).
WA429	Too many requests	Yes	Customer's Technology team.	Implement 3 retry attempts with intervals of 5, 10, and 15 minutes.
WA429	Too many requests	Yes	Customer's Operations team.	After 3 retry attempts, if the issue is still not resolved, escalate the case to the Tata Communications Operations team.
WA500	Internal Server Error	Yes	Customer's Technology team.	Implement 3 retries with intervals of 5, 10 and, 15 minutes.
		Yes	Customer's Operations team.	After 3 retry attempts, if the issue persists, escalate the case to the Tata Communications Operations team.

Sample Success Responses

The following are the sample success responses:

Create Template

{
"code": "WA200",
"message": "Request Processed Successfully",
"data": {
"id": "<ID>",
"status": "<STATUS>",
"category": "<CATEGORY>"
},
"error": {}
}

Get Template

{
"code": "WA200",
"message": "Request Processed Successfully",
"data": [
{
"category": "MARKETING",
"company_id": "Z8aeXXXXXXXXa",
"components": [
{
"example": {
"header_text": [
"TC"
]
},
"format": "TEXT",
"text": "Hii! {{1}}, Get ready fans",
"type": "HEADER"
},
{
"text": "Greetings",
"type": "BODY"
},
{
"text": "KIO",
"type": "FOOTER"
}
],
"language": "en_US",
"name": "greetings9",
"status": "APPROVED",
"waba_id": "121289654XXXXXX",
"whatsapp_template_id": "14079075XXXXXXXXX"
}
],
"error": {},
"limit": 25,
"offset": 0,
"total": 1
}

Edit Template

{
"code": "WA200",
"message": "Request Processed Successfully",
"data": {
"success": <bool>
},
"error": {}
}

Delete Template

{
"code": "WA200",
"message": "Request Processed Successfully",
"data": {
"success": <bool>
},
"error": {}
}

Sample Failure Responses

The following are the sample failure responses:

Incorrect SID or API Key

401 Unauthorized
{
"code": "RBC001",
"message": "Incorrect SID or API key.",
"data": [],
"error": {
"body": "Incorrect SID or API key.",
"error": "record not found"
}
}

Unauthorized Account type

{
"code": "WA401",
"message": "API is not available for given customer.Please contact support for more info",
"data": {},
"error": {
"account": "API is not available for given customer.Please contact support for more info"
}
}

Incorrect payload

{
"code": "WA400",
"message": "Refer to correct payload format",
"data": {},
"error": {
"payload": "Incorrect payload format"
}
}

Invalid Status

{
"code": "WA400",
"message": "invalid status given. valid values are : accepted, pending, rejected, paused, disabled",
"data": [],
"error": {
"status": "invalid status given. valid values are : accepted, pending, rejected, paused, disabled"
}
}

Invalid Category

{
"code": "WA400",
"message": "invalid category given. valid values are : marketing, utility, authentication",
"data": [],
"error": {
"category": "invalid category given. valid values are : marketing, utility, authentication"
}
}

Invalid limit

{
"code": "WA400",
"message": "please provide a valid positive number",
"data": [],
"error": {
"limit": "please provide a valid positive number"
}
}

Invalid Offset

{
"code": "WA400",
"message": "please provide a valid positive number",
"data": [],
"error": {
"offset": "please provide a valid positive number"
}
}

Unauthorized WABA

  {
  "code": "WA401",
  "message": "Waba_Id is not present or does not belong to the account.",
  "data": {},
  "error": {
  "waba_id": "Waba_Id is not present or does not belong to the account."
  }
  }

Unauthorized WABA version

{
"code": "WA401",
"message": "The waba_id you're using is associated with different Version of our WA API. Please use the appropriate endpoint.",
"data": {},
"error": {
"waba_id": "The waba_id you're using is associated with different Version of our WA API. Please use the appropriate endpoint."
}
}

Rate Limit Hit: Rate limit of 100 Templates per WABA per Hour

{
"code": "WA429",
"message": "Rate limit hit",
"data": {},
"error": {
"error": "Too many requests sent from this waba in a short period of time, please try after sometime"
}
}

📘
Note:
For Meta's list of error codes, see Error response content.

Updated 20 minutes ago