How to get a WhatsApp template approved first time

Why templates need approval

A template is a message Meta has approved in advance. Meta's pricing page says a business can only send a free-form message inside the 24-hour window after a customer writes. Outside it, the business must use a template. Order updates, login codes, reminders and offers are all templates.

Meta reviews each template before you can use it. Meta's Template review page says it can take up to 24 hours for a decision (checked November 2026).

1. Choose the right category

The category is the first thing to get right. It must match what the message really does. Meta's Template categorization page describes them like this (checked November 2026):

• Marketing: messages that promote, from making people aware of you to driving sales and bringing customers back.
• Utility: a follow-up to something the customer did or asked for, like an order, an account or a payment. It must not promote anything.
• Authentication: checking a customer's identity, for example with a one-time code.

A common trap is a utility message with a sales line added at the end, like "Your order has shipped. Use code SAVE10 on your next order." Meta's page says a template with mixed content, such as "an order update with a promo", counts as marketing. Meta's template status webhook has a rejection reason for this, `INCORRECT_CATEGORY`: the content does not match the category chosen when the template was made.

If you want both, make two templates.

2. Write variables the way Meta expects

Variables are the parts that change for each person, such as a name or an order number. They are written as numbers in double curly brackets: {{1}}, {{2}}, and so on.

Meta's Template review page lists these common reasons for rejection (checked November 2026):

• Missing or mismatched curly brackets, like {{1} or {1}}.
• Numbers that are not in order, like {{1}}, {{2}}, {{5}}, {{4}}.
• A variable at the very start or the very end of the message.
• Too many variables for the length of the message.
• Symbols such as #, $ or % inside a variable.

Meta's template status webhook also gives this example of a rejection: variables placed next to each other, like {{1}}{{2}}, with no text or punctuation between them.

A good habit: always put a few plain words before the first variable and after the last one.

Weak: "{{1}}, your order is ready."

Better: "Hi {{1}}, your order {{2}} is ready to collect."

3. Give a real example for every variable

Meta's reviewers need to see what the message will look like. Meta's Template review page says that if a template uses variables, you must include sample values, such as text and media, with your submission. The WhatsApp changelog for 4 April 2023 says samples are needed when a template is created or edited.

Use realistic examples: "Priya" for a name, "#10482" for an order. Avoid "test", "xxx" or "{{1}}". For a photo, video or document header, upload a real sample file.

4. Keep the wording clear and within the rules

Meta's Template review page says templates with spam, scam-like content, or content that breaks WhatsApp's policies are rejected (checked November 2026). Its examples:

• content that breaks WhatsApp's Commerce Policy;
• asking people for sensitive details, such as full payment card numbers, financial account numbers or national ID numbers;
• abusive or threatening content, such as threatening a customer with legal action or public shaming;
• a duplicate: a template with the same wording in the body and footer as one you already have.

Some simple habits help too:

• Say who you are. Customers should know the message is from your business.
• Write the way you speak. Short sentences, no shouting in capital letters.
• Stay within the length limits for each part: header, body, footer and buttons.
• Make link buttons point to your own website.

5. If it is rejected, read the reason and edit

A rejection is not the end. Meta's Template review page says you can edit a rejected template and submit it again, or appeal the decision.

For format problems (reason `INVALID_FORMAT`), Meta's template status webhook can include an explanation of the problem and a recommendation on how to fix it.

How Qubox helps

Qubox has a template form that checks your template while you type, before anything goes to Meta. Under a live preview of the message, it checks:

• the template name,
• the length of each part,
• that {{1}}, {{2}} and the rest are in order,
• that every variable has an example,
• that no variable sits at the very start or end of the message.

When Meta replies, Qubox shows the status, and for a rejected template, Meta's reason. You can edit an approved, rejected or paused template and send it to Meta again. The name and language stay the same. The form covers text, photo, video and document headers, a map pin, buttons (link, quick reply, phone, copy code), limited-time offers and carousels of 2 to 10 cards.

Once a template is approved, use it in a campaign, from the team inbox after the 24-hour window closes, or from your own software through the API.

Sources

• Template review, Meta for Developers — review time, common rejection reasons, sample values, edit and appeal
• Template categorization, Meta for Developers — marketing, utility, authentication; mixed content counts as marketing
• message_template_status_update webhook reference, Meta for Developers — rejection reasons, explanation and recommendation for format problems
• WhatsApp changelog, Meta for Developers — samples needed on create and edit (4 April 2023)
• Pricing on the WhatsApp Business Platform, Meta for Developers — templates needed outside the 24-hour window

Questions