Skip to content
Meta Business PartnerAPI error reference

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.

2388040
Code
Character limit exceeded
Meta's name
Template management
Type
On a set-up call, not a send
Where you see it
After fixing the cause
Retry

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.

Send it through InfiQ

Frequently asked questions

What are the WhatsApp template character limits?+
The body can be up to 1,024 characters, and text headers and footers up to 60 each. Buttons have their own short label limits, and the error message names the limit you hit.
Do emoji count toward the limit?+
Yes. Emoji and formatting characters are characters too, so count them when you trim a field.
Is 2388040 the same as error 132005?+
No. 2388040 is returned when you create or edit a template that's too long; 132005 is returned at send time when the filled-in text is too long.
How do I know which field is too long?+
Meta's error message for 2388040 names the affected field and its limit, so read it before editing. Shortening the wrong field just returns the same error.