WhatsApp Cloud API · error code

WhatsApp error 2388019: Message Template Limit Exceeded

ConfigurationTemplates & Flows

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
You have exceeded the maximum number of message templates you can have for this WhatsApp business account.

What error 2388019 means

Code 2388019 is returned when you try to create a template on a WhatsApp Business Account that already holds as many templates as it is allowed. It is a quota on how many templates exist, not on how many messages you send, so it surfaces from POST /<WABA_ID>/message_templates and from template creation in WhatsApp Manager.

The ceiling depends on verification. Meta's template overview states that each WABA under an unverified business portfolio is limited to 250 templates, while a verified portfolio with at least one business phone number holding an approved display name gets up to 6,000 per WABA. Every language counts separately: one template name translated into five languages consumes five slots.

Old, unused templates still count until they are deleted, which is why long-lived accounts reach the cap after years of campaign-specific templates.

What it looks like

{
  "error": {
    "code": 2388019,
    "error_data": {
      "messaging_product": "whatsapp",
      "details": "You have exceeded the maximum number of message templates you can have for this WhatsApp business account."
    }
  }
}

Why it happens

  • Years of one-off campaign templates that were never cleaned up.
  • Each template created in many languages, multiplying slot usage.
  • Automated tooling that creates a fresh template per send instead of reusing parameters.
  • The business portfolio is unverified, so the lower 250 ceiling applies.

How to fix WhatsApp error 2388019

  1. 1List templates with GET /<WABA_ID>/message_templates?fields=name,language,status and count entries per name and language.
  2. 2Delete unused or rejected templates; up to 100 IDs can be removed in one call using the hsm_ids parameter.
  3. 3Remember that deleting an approved template blocks reuse of its name for 30 days, so do not delete one you plan to recreate.
  4. 4If you legitimately need more, complete business verification and get a display name approved to qualify for the higher ceiling.
  5. 5Retry the creation request once slots are free.

How to stop it recurring

Design templates as reusable shapes with variables rather than one per campaign, and run a monthly job that flags templates unused for a long period. Track your count against the ceiling, which is listed under template limits, and alert well before you hit it.

Official reference: Meta for Developers - Cloud API error codes. See all WhatsApp error codes or the WhatsApp limits and quotas.

Related codes

Error 2388019 - quick answers

What does WhatsApp error 2388019 mean?

Code 2388019 is returned when you try to create a template on a WhatsApp Business Account that already holds as many templates as it is allowed. It is a quota on how many templates exist, not on how many messages you send, so it surfaces from POST /<WABA_ID>/message_templates and from template creation in WhatsApp Manager. The ceiling depends on verification.

How do I fix WhatsApp error 2388019?

1. List templates with GET /<WABA_ID>/message_templates?fields=name,language,status and count entries per name and language. 2. Delete unused or rejected templates; up to 100 IDs can be removed in one call using the hsm_ids parameter. 3. Remember that deleting an approved template blocks reuse of its name for 30 days, so do not delete one you plan to recreate. 4. If you legitimately need more, complete business verification and get a display name approved to qualify for the…

Stop debugging WhatsApp by hand

Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.