Skip to content
Automation

WhatsApp Business API templates: approval guide

How WhatsApp Business API templates get reviewed: categories, Meta's most common rejection reasons and how to appeal when yours gets rejected.

4 min read

Templates are the only type of message you can send through the WhatsApp Business API outside the 24-hour service window. That makes them the bottleneck of any automation: if your template isn't approved, your appointment reminder, order confirmation or campaign simply doesn't go out. As a Meta Tech Provider we go through this process with every client, so here is the practical guide, based on Meta's official template documentation.

What Meta reviews and why

Every template you create (through the API or from WhatsApp Manager) goes through an automated review, with manual reviews in some cases. Meta validates that the content meets its policies and quality standards: templates with spam, scam-like content or policy violations get rejected. The decision takes up to 24 hours and reaches you as a notification in WhatsApp Manager, an email to the Business Suite admins, and a webhook if you're integrated through the API.

Three structural rules before you write a single word:

  • The name accepts only lowercase letters, numbers and underscores, up to 512 characters.
  • Each language is a separate template: Meta translates nothing, you provide the copy in every language.
  • Every template carries a category (marketing, utility or authentication) which also defines how much it costs to send. If you miscategorize, Meta can recategorize it.

The most common rejection reasons according to Meta

The template review documentation lists the errors that generate the most rejections. We see them repeat in practice:

Badly formatted variables

  • Incomplete or mismatched braces: the correct format is {{1}} for positional parameters or {{name}} in lowercase for named parameters.
  • Variables with special characters like #, $ or %.
  • Positional parameters out of sequence: {{1}}, {{2}}, {{5}} is a guaranteed rejection.
  • The template can't start or end with a variable. This is the most frequent rejection we fix: "{{1}}, your order is ready" doesn't pass; "Hi {{1}}, your order is ready. Thank you." does.
  • Too many variables for how short the text is. Either cut variables or lengthen the message.

Policy violations

  • Asking for sensitive identifiers: full card numbers, bank accounts, official IDs. Asking for partials (last 4 digits) is allowed.
  • Content that breaks the WhatsApp commerce policy in the products or services you offer.
  • Threatening tone: warning of legal action or publicly shaming the customer is a direct rejection.

Duplicates

If you submit a template with the same body and footer as one that already exists in your account, the new one gets rejected as a duplicate. The notification in Business Support Home tells you which existing template caused the conflict.

The trick that avoids half the rejections: samples

If your template uses variables, you must include example values (sample text and, if it carries media, the example asset). The sample lets the reviewer see the message as your customer would see it. A template with variables and no clear context is ambiguous for the review system; with realistic samples, the intent is evident. In WhatsApp Manager it's the "Add Sample" button before submitting.

If you get rejected: edit or appeal

A rejection is not the end. You have two paths:

  1. Edit and resubmit: you fix the problem and the template goes back into review (another 24 hours at most).
  2. Appeal: if you believe the rejection was a mistake, you can request reconsideration from WhatsApp Manager. The appeal must include samples and is resolved in about 24 hours.

The rejection reason shows up in Business Support Home and arrives by email, so you don't have to guess.

Approved doesn't mean approved forever

Meta scores the quality of every active template based on user reactions: blocks, reports and read rates. A template with recurring negative feedback moves to paused and then to disabled, and in those states it can no longer be sent. The operational lesson: don't saturate. If you send the same promotion to your whole list every week, the accumulated blocks end up killing the template even though it passed review. We touch on this too when comparing ManyChat against the direct API: the tool matters less than the sending discipline.

One more limit worth knowing: an account with an unverified business can hold up to 250 templates; with a verified portfolio and an approved display name, up to 6,000.

Checklist before submitting for review

  • Lowercase name with underscores, descriptive.
  • Correct category (don't label as utility what is marketing: Meta recategorizes).
  • No variable at the start or end of the text.
  • Sequential variables, no special characters.
  • Realistic samples for every variable and every media asset.
  • No requests for sensitive data, no threatening tone.
  • Check it doesn't duplicate an existing template.

Designing WhatsApp Business API templates that get approved on the first try and that customers don't block is half the job of a good automation. It's part of what we do in our WhatsApp automation service: flows, templates and the full operation, with your account verified and your messages going out on time.