WhatsApp API Error Codes

Error CodeDescriptionDetailsPossible Reasons & SolutionsHTTP Status
0AuthExceptionUnable to authenticate the app user.Access token expired, revoked, or invalid. Generate a new access token and reconnect the account.401
10Permission DeniedPermission not granted.Required permissions are missing or removed. Re-authorize the WhatsApp Business account.403
190Invalid OAuth TokenToken expired or invalid.Generate a new access token and update it in your integration settings.401
200Permission ErrorUser does not have permission.Ensure the app has required WhatsApp permissions and is approved.403
131000Message Send FailedUnable to deliver message.Recipient number is invalid or unreachable. Verify the phone number format.400
131009Message Type Not SupportedUnsupported message type.Ensure the message format (text, template, media) is valid and approved.400
131047Re-engagement RequiredUser has not interacted in 24 hours.Use an approved message template to re-initiate conversation.403
131053Media Download FailedMedia URL inaccessible.Ensure media URL is publicly accessible and uses HTTPS.400
132000Template Not FoundTemplate does not exist.Check template name, language code, and approval status.404
132001Template Parameter MissingRequired parameter missing.Ensure all placeholders in the template are filled correctly.400
132005Template Not ApprovedTemplate is pending or rejected.Submit the template for approval and wait for Meta approval.403
132007Template PausedTemplate is paused by Meta.Review template compliance and re-submit if required.403
131026Phone Number Not RegisteredNumber not linked to WhatsApp.Ensure the phone number is registered and verified.400
131030Business Account InactiveWhatsApp Business account inactive.Verify business account status in Meta Business Manager.403
131031Account Rate LimitedToo many requests.Reduce message rate or request a higher messaging tier.429
131052Media Upload FailedMedia file upload failed.Check file size, format, and upload URL.400
131056Unsupported Media TypeFile type not supported.Use supported formats (JPEG, PNG, MP4, PDF).400
1Unknown ErrorGeneric system error.Retry request after some time. If persistent, contact support.500
2Service UnavailableWhatsApp servers unavailable.Retry after some time. Monitor Meta status updates.503
4Rate Limit ExceededToo many API calls.Reduce API requests or upgrade rate limits.429