WhatsApp error 2388019: Message Template Limit Exceeded
Last verified against Meta for Developers - Cloud API error codes
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
- 1List templates with
GET /<WABA_ID>/message_templates?fields=name,language,statusand count entries per name and language. - 2Delete unused or rejected templates; up to 100 IDs can be removed in one call using the
hsm_idsparameter. - 3Remember that deleting an approved template blocks reuse of its name for 30 days, so do not delete one you plan to recreate.
- 4If you legitimately need more, complete business verification and get a display name approved to qualify for the higher ceiling.
- 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
- 2388039: Message template status can't be changedThe status for this message template can't be changed. You can only delete or…
- 132001: Template does not existThe template does not exist in the specified language or the template has not…
- 200007: Template Insights not enabledTemplate Insights have not been enabled for this WhatsApp Business Account
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.