WhatsApp Template Message Errors: The Complete Guide

When a WhatsApp template message fails to send, Meta returns a numeric error code that tells you exactly why the message was rejected or not delivered. This guide lists the most common template error codes, explains what causes them, and links to a step-by-step fix for each one.

Why Template Messages Fail

Template messages travel through the WhatsApp Business API, so a failure can happen at several points:

• Your account: Unpaid Meta bills, missing payment methods, or messaging limits on your WhatsApp Business Account.
• Your template: A template that is still pending approval, or whose name and language do not match what is being sent.
• The recipient: A number that is not on WhatsApp, a user who blocked you, or Meta protections that limit how many marketing messages one person receives.

The error code tells you which of these happened, so always start by finding the exact code in your message logs or automation failure list before changing anything.

Common Error Codes and Fixes

Each article below covers one error code in full: what it means, quick checks, resolution options, and when to escalate.

• Error 130472: User's number is part of an experiment - WhatsApp is running an experiment that restricts messaging to this recipient.
• Error 131026: Message undeliverable - WhatsApp cannot deliver to the recipient (not on WhatsApp, outdated app, blocked, or unaccepted terms).
• Error 131042: Business eligibility payment issue - a Meta billing problem, usually an unpaid bill or no default payment method.
• Error 131048: Spam rate limit hit - your account hit its business-initiated conversation limit in a rolling 24-hour window.
• Error 131049: Meta chose not to deliver - Meta's healthy ecosystem protection capped marketing messages to this recipient.
• Error 132001: Template name does not exist - the template is still pending, or the name/language does not match an approved translation.