WhatsApp chat widget on a website

Want to Use WhastApp API?

WhatsApp Message Templates via the API

Picture of Mumble Team

Mumble Team

October 8, 2026| Reading Time: 2 minutes

In short: A message template is a message approved by Meta in advance. It is the only way to write to a customer outside the 24-hour window, and the only kind of message a campaign can send. You can create and send templates in Mumble or through the Mumble API. A template cannot be edited, so get it right before you save it.

Choose the right category

  • Marketing: promotions, launches, abandoned cart, surveys. The most expensive. The customer must have opted in.
  • Utility: an update about something the customer did: an order, an appointment, a payment. No promotion at all.
  • Authentication: a one-time code only, with no links or emojis.

One promotional sentence makes the whole template Marketing. If the content is mixed, split it into two templates. Prices: Paying Meta and WhatsApp Messaging Costs.

What a template can contain

  • Header (optional): text, image, video, document or audio. A text header cannot have variables.
  • Body (required): up to 1,024 characters, with numbered variables {{1}}, {{2}} in order. A variable cannot open or close the text, and two variables cannot sit side by side.
  • Footer (optional): plain text, up to 60 characters.
  • Buttons (optional): up to 10 in total, including up to 2 link buttons and 1 phone button.

Name rules: up to 30 characters, lowercase English letters, numbers and underscores, unique in the account. Use one language per template, for example welcome_en and welcome_he. In Marketing templates, add the opt-out button from the opt-out word picker. See Opt-Out and Blacklist.

Templates through the API

Endpoint What it does
GET /get-templates Lists your templates
POST /create-template Creates a template and sends it to Meta for approval
POST /send-template Sends an approved template with no variables
POST /send-template-text-variable Sends an approved template with variables
GET /is-active-conv Checks if the customer’s 24-hour window is open

Check the window first: if it is open, you can send free text. If it is closed, send a template. The API key and sending limits are in The Mumble API: The Complete Guide.

Approval

  1. Save the template in Mumble, or create it through the API. It appears under Pending.
  2. Mumble sends it to Meta automatically.
  3. Meta answers within minutes, and at most about 24 hours.
  4. Approved templates move to Approved and can be sent. Rejected ones move to Rejected with a reason.

To fix a template, delete it and create a new one with a new name. See Message Template Rejected?.

Common questions

The template name is not accepted

It has spaces, capital letters or non-English letters, or the name is taken. Add a suffix like _v2.

An approved template fails through the API

Check that the phone number is in international format with no + or leading 0 (972501234567), and that the number of variables matches the body. Also check your messaging limit.

Some Marketing messages are not delivered

Meta limits how many marketing messages one person gets from all businesses (error 131049), and does not deliver Marketing templates to US (+1) numbers. Do not retry right away.

My template was paused

Too many blocks or spam reports. Meta pauses it for 3 hours, then 6 hours, then disables it. Send to a smaller, opted-in audience.

Related articles

Picture of Mumble Team

Mumble Team

מאמבל מתמחה בשינוי תקשורת עסקית באמצעות פתרונות וואטסאפ חדשניים. עם התמקדות באופטימיזציה של מכירות, ניהול לידים ואוטומציה של אירוסי לקוחות, Mumble מעצים עסקים לצמוח בצורה חכמה ומהירה יותר. עם תשוקה ליעילות וחדשנות, הצוות ממשיך להגדיר מחדש איך חברות מתחברות עם הלקוחות שלהן.