WhatsApp API Template Rejected – Reasons & Solutions

Introduction

To initiate a chat on the WhatsApp Business API, you must use a Meta-approved message template (HSM). Meta reviews these to prevent spam and ensure quality. If a template violates formatting or content policies, it is rejected. In 2026, Meta’s automated review process is stricter than ever, making it vital to understand exact compliance rules to avoid campaign 

Category Mismatch

gemini generated image 312xtq312xtq312x

Reason: You chose Utility but the content is Marketing. In 2026, Meta is very strict about this because Marketing costs more. Even a small promo word like “special offer” in an order update will cause rejection.
 Solution  If your message has any promotional intent, always select Marketing. Keep Utility templates strictly for facts like “Your order #123 is out for delivery.”

 

Variable Placement Errors

gemini generated image ust9gbust9gbust9

Reason: Placing a variable at the very start or the very end of a sentence (e.g., “{{1}} is your code”). Meta thinks this makes the message too generic and open to spam.
 Solution: Always wrap variables with text. Use: “Your secret login code is {{1}}.” Ensure variables are sequential: {{1}}, {{2}}, {{3}} without skipping numbers.

Prohibited Link Shorteners

gemini generated image 7irlny7irlny7irl

Reason: The message does not make sense to the reviewer (e.g., “Hi {{1}}, thanks for the update”). Meta needs to know exactly what the “update” is about.
 Solution: Be specific. Use: “Hi {{1}}, thanks for updating your shipping address for order {{2}}.”

🚀 WhatsApp API Template Rejected – Reasons & Solutions

Template rejection happens when messages violate Meta's policies or formatting rules. Common causes include category mismatch, using link shorteners, or floating variables. By ensuring clear context, sequential numbering, and proper category selection (Marketing vs Utility), businesses can ensure instant approval and maintain a high-quality messaging rating.

🛠️ Fix Your Templates

Missing Sample Values

gemini generated image b5zo1kb5zo1kb5zo
  1. Reason: When you submit a template with variables like {{1}}, you must provide a “Sample” of what that data will be. If the sample is missing, the template is rejected.

    Solution: Always fill out the Sample Content section in the Meta dashboard before clicking submit.

WhatsApp API Template Rejection Guide 2026

WhatsApp API Guide
Reason for Rejection Explanation Practical Solution
Category Mismatch Using Utility for promotional content to save money. Mark any message with offers or "buy now" as Marketing.
Floating Variables Placing {{1}} at the start or end without context. Always wrap variables in text (e.g., "Hi {{1}}, your code is {{2}}").
Link Shorteners Using bit.ly or tinyurl which looks like a scam. Use your full branded domai e.g(https://cnmacademy.com/) .
Missing Samples Not showing Meta what data goes in the placeholders. Always fill the Sample Content section before submitting.

Questions & Answers

What is "Template Pacing" and why does it cause message delays?

In 2026, Meta uses Pacing to check the quality of new templates. When you start a broadcast, Meta sends the message to a small sample of users first. If those users report or block you, Meta pauses the remaining messages automatically.

This happens when you submit a message under the Utility category but include any marketing language (e.g., “Check our new collection” or “Use code SAVE10”).

Yes, but only one variable is allowed in the header. You cannot use multiple placeholders like {{1}} and {{2}} in a header. The body, however, can have multiple variables.

This occurs when variables are “floating” without enough surrounding text (e.g., Hi {{1}}, {{2}}). Meta considers this a spam risk because the message context is unclear.

Solution: Add at least 3–4 words of static text between variables.

Meta has streamlined the scaling process. Once you complete Business Verification, many accounts now jump directly to the 100K/day limit (Tier 3) rather than waiting weeks to move from 1K to 10K. However, your Quality Rating is now more strictly monitored.

Leave a Comment

Your email address will not be published. Required fields are marked *