Reference

Errors

Error format and what each code means.

Errors use a normal HTTP status code and a JSON body with a machine-readable code and a human-readable message.

Error response · json

{
  "code": "SESSION_EXPIRED",
  "message": "24-hour conversation window is closed. Send a template message instead.",
  "details": null
}

Error codes

`400 VALIDATION`	A required parameter is missing, such as `Contact` or `Message`.
`400 SESSION_EXPIRED`	The 24-hour window is closed. Send a template instead.
`400 WHATSAPP_NOT_CONNECTED`	No active WhatsApp number is connected to this license.
`401 API_AUTH_REQUIRED`	`LicenseNumber` or `APIKey` was not sent.
`401 API_AUTH_INVALID`	The license number or API key is wrong.
`403 ACCOUNT_INACTIVE`	The account is suspended, expired, or not active for sending.
`404 TEMPLATE_NOT_FOUND`	No template with that name exists in your account.
`429 RATE_LIMITED`	Too many requests. Wait and try again.
`500 INTERNAL_ERROR`	Something went wrong on our side. Try again shortly.

Phone number: use country code and digits only, for example 919876543210
Template not found: the name is case-sensitive and the template must be approved
Nothing arrives: check the message status in your inbox; WhatsApp can reject a message after we accept it
Special characters: URL-encode values (spaces, &, #). The code samples do this for you