WhatsApp error 2388039: Message template status can't be changed
Last verified against Meta for Developers - Cloud API error codes
The status for this message template can't be changed. You can only delete or add templates.What error 2388039 means
Code 2388039 means you tried to edit a template that is currently not editable. Meta's explanation in the error table gives the typical case: a template still in review cannot be modified, so wait for it to be approved or rejected first. The template management guide narrows this down further: only templates with an APPROVED, REJECTED, or PAUSED status can be edited.
Edit quotas also apply. An approved template can be edited up to 10 times in a 30-day window, or once in a 24-hour window, while rejected or paused templates can be edited without limit. The category of an approved template cannot be edited at all, and an edit replaces every component rather than patching one.
Nothing is wrong with the content you submitted. The template's current state simply does not accept edits right now.
What it looks like
POST https://graph.facebook.com/v23.0/<TEMPLATE_ID>
{
"components": [
{ "type": "BODY", "text": "Your appointment is on {{1}}." }
]
}
(template status is PENDING, so the edit is refused with 2388039)Why it happens
- Submitting an edit while the template is still
PENDINGreview. - A deploy script that creates then immediately edits the same template.
- Exceeding the edit allowance for an approved template within the window.
- Trying to change the category of a template that is already approved.
How to fix WhatsApp error 2388039
- 1Fetch the template's current
statusand only edit when it is APPROVED, REJECTED, or PAUSED. - 2If it is pending, wait for the
message_template_status_updatewebhook before editing. - 3Send the full component set in the edit payload, since the API replaces all components.
- 4If you need a different category on an approved template, create a new template instead of editing.
- 5If you are out of edits for the window, schedule the change for later.
How to stop it recurring
Make template edits state-aware: gate them on the status from your cached template list and queue anything that arrives while review is running. Batch copy changes so an approved template is edited once with every change instead of several times in a day.
Official reference: Meta for Developers - Cloud API error codes. See all WhatsApp error codes or the WhatsApp limits and quotas.
Related codes
- 2388019: Message Template Limit ExceededYou have exceeded the maximum number of message templates you can have for…
- 132015: Template is PausedTemplate is paused due to low quality so it cannot be sent in a template…
- 132001: Template does not existThe template does not exist in the specified language or the template has not…
Error 2388039 - quick answers
What does WhatsApp error 2388039 mean?
Code 2388039 means you tried to edit a template that is currently not editable. Meta's explanation in the error table gives the typical case: a template still in review cannot be modified, so wait for it to be approved or rejected first. The template management guide narrows this down further: only templates with an APPROVED , REJECTED , or PAUSED status can be edited. Edit quotas also apply.
How do I fix WhatsApp error 2388039?
1. Fetch the template's current status and only edit when it is APPROVED, REJECTED, or PAUSED. 2. If it is pending, wait for the message_template_status_update webhook before editing. 3. Send the full component set in the edit payload, since the API replaces all components. 4. If you need a different category on an approved template, create a new template instead of editing. 5. If you are out of edits for the window, schedule the change for later.
Stop debugging WhatsApp by hand
Connect the channel through Conferbot: tokens, webhooks and retries are handled, failures show as readable status.