WhatsApp API error 2388040: Character limit exceeded
Error 2388040 means one part of the template you're creating is longer than WhatsApp allows for that part. The error message tells you which field it is.
Quick answer
A template field is over its character limit. Read the error message for the field, shorten it to fit, and submit again.What WhatsApp error 2388040 means
Meta documents 2388040 as: a field in your template has exceeded the maximum character limit allowed, and advises reading the error message for the affected field and its limit.
Why error 2388040 happens
Meta checks a template when you create or change it, and these errors say which rule it broke. The usual reasons:
- A body longer than the 1,024-character template body limit.
- A text header or footer longer than its 60-character limit.
- Button text longer than the button label limit.
- Sample values or variables that push a field over its limit.
- Long button labels or URLs copied from a website.
How to fix error 2388040
Work through these in order; the first one that turns up a problem is usually the fix.
- Read the error message to see which field and which limit.
- Shorten that field: move detail behind a button link, cut repetition, and keep headers short.
- Count characters after any formatting characters and emoji, which also count.
- Submit the template again.
- Keep a list of field limits next to whoever writes templates.
Should you retry after 2388040?
Resubmit after shortening the field; the same template fails again unchanged.
How error 2388040 shows up in InfiQ
This code belongs to set-up work rather than sending: templates, number registration or onboarding. When InfiQ's API makes that call for you, such as creating a template, the response carries Meta's error object (code 2388040, error_data.details) and an InfiQ_traceid; during registration or onboarding with InfiQ's team, pass the code and details to support.
Frequently asked questions
What are the WhatsApp template character limits?+
Do emoji count toward the limit?+
Is 2388040 the same as error 132005?+
How do I know which field is too long?+
Build templates that pass review first time
Create and submit templates from InfiQ, with the approved list and each template's status in one place.