WhatsApp

Update template

Update one variant's components. Name, language and category cannot change after creation.

Meta stores one template per name + language, so a name identifies a family of variants, each with its own Meta id. Pass language to address one variant. Without it, a name with a single variant resolves to that variant; a name with several returns 409 ambiguous_template with details.languages. A bare language (es) matches a single regional variant (es_ES); if the family has several regional variants for it, that is also a 409. A full code (es_ES) must match exactly. Variants in PENDING_DELETION are not part of the family.

Meta only allows editing templates in APPROVED, REJECTED or PAUSED state; an approved template can be edited once per 24 hours and up to 10 times per 30 days. A successful update sends the variant back to Meta for review, so the status returned here is normally PENDING. The final outcome arrives on the whatsapp.template.status_updated webhook (which carries the variant's templateId and language). A variant already in PENDING cannot be edited again until Meta finishes reviewing it.

patch/v1/whatsapp/templates/{templateName}

Path parameters

templateNamestring required

Template name (the family).

Request body

accountIdstring required

WhatsApp social account ID

languagestring

Language code of the variant to edit (e.g. en_US, es, pt_BR). Required when the family has several languages. Body only: a language query parameter on PATCH is a 400.

Response

Template updated successfully

successboolean

Example response

{
  "template": {
    "status": "PENDING"
  }
}

Changes

Changed in 1 of the 26 revisions of this API.14

  • e6f7a453bfb114See the full diff
    • removed the media type application/json for the response with the status 404

      response-media-type-removed

    • added the new optional request property language

      new-optional-request-property

    • added the media type application/json for the response with the status 400

      response-media-type-added

    • added the non-success response with the status 409

      response-non-success-status-added

    • added the optional property template/language to the response with the 200 status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog