WhatsApp Cloud API · error code

WhatsApp error 2388039: Message template status can't be changed

ConfigurationTemplates & Flows

Last verified against Meta for Developers - Cloud API error codes

What WhatsApp returns
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 PENDING review.
  • 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

  1. 1Fetch the template's current status and only edit when it is APPROVED, REJECTED, or PAUSED.
  2. 2If it is pending, wait for the message_template_status_update webhook before editing.
  3. 3Send the full component set in the edit payload, since the API replaces all components.
  4. 4If you need a different category on an approved template, create a new template instead of editing.
  5. 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

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.