WhatsApp error 2388047: Message header format is incorrect
Last verified against Meta for Developers - Cloud API error codes
Your message header contains invalid formatting.What error 2388047 means
Code 2388047 rejects a template at creation or edit time because the HEADER component is malformed. Meta's table only says the header contains invalid formatting and points you at the detailed message returned with the error, so the specifics live in that message.
The components reference spells out what a valid text header looks like: one header per template, at most 60 characters, at most one parameter, and no Markdown special characters. When the header uses a parameter, an example value must be supplied. Media headers (image, video, document) are a different format and need a sample handle rather than text.
Header problems are easy to introduce because many teams treat the header as a styled title and try to bold it with asterisks or add emoji and line breaks. The body tolerates far more formatting than the header does.
What it looks like
{
"type": "HEADER",
"format": "TEXT",
"text": "*Order {{1}}* for {{2}}"
}
(Markdown characters and a second parameter both break the documented text-header rules)Why it happens
- Asterisks, underscores, or tildes in the header to imitate WhatsApp bold or italic styling.
- Two or more variables in a text header, which allows only one.
- A header parameter submitted without its
examplevalue. - A
formatvalue that does not match the content supplied (for example IMAGE with text). - A media header (IMAGE, VIDEO or DOCUMENT) submitted without an
example.header_handle, the sample file handle that template creation requires for media headers.
How to fix WhatsApp error 2388047
- 1Read the error message returned with 2388047 for the exact rule broken.
- 2Strip Markdown characters and line breaks from the header text.
- 3Reduce the header to a single variable and add an
examplefor it. - 4Confirm the header
formatmatches its content and resubmit. - 5For media headers, upload a sample with the Resumable Upload API first and pass the returned handle as
example.header_handlein the HEADER component.
How to stop it recurring
Keep headers plain: a short label with at most one variable. Lint header text in your builder for formatting characters before submission, and keep a known-good header JSON per format (text, image, document) to copy from rather than hand-writing new ones.
Official reference: Meta for Developers - Cloud API error codes. See all WhatsApp error codes or the WhatsApp limits and quotas.
Related codes
- 2388072: Message body format is incorrectYour message body contains invalid formatting.
- 2388073: Message footer format is incorrectYour message footer contains invalid formatting.
- 2388040: Character limit exceededA field in your template has exceeded the maximum character limit allowed.
- 132012: Template Parameter Format MismatchVariable parameter values formatted incorrectly.
Error 2388047 - quick answers
What does WhatsApp error 2388047 mean?
Code 2388047 rejects a template at creation or edit time because the HEADER component is malformed. Meta's table only says the header contains invalid formatting and points you at the detailed message returned with the error, so the specifics live in that message.
How do I fix WhatsApp error 2388047?
1. Read the error message returned with 2388047 for the exact rule broken. 2. Strip Markdown characters and line breaks from the header text. 3. Reduce the header to a single variable and add an example for it. 4. Confirm the header format matches its content and resubmit. 5. For media headers, upload a sample with the Resumable Upload API first and pass the returned handle as example.header_handle in the HEADER component.
Stop debugging WhatsApp by hand
Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.