Skip to content

POST /v1/templates/{template_id}

Edits one template’s category and/or components, and resubmits it for WhatsApp’s review where required. This is Meta’s own edit method: POST, not PUT.

Terminal window
curl -X POST "$HELLO_API_URL/v1/templates/1234567890123456" \
-H "Authorization: Bearer $HELLO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"components": [
{ "type": "BODY", "text": "Hi {{1}}, your order {{2}} has shipped and is now in transit." }
]
}'
Field Type Required Description
category string No New category
parameter_format string No NAMED or POSITIONAL
components array No Replacement components, in the same format as create

Only the fields you send are changed; name and language can’t be edited (create a new template for a different name or language). The body is forwarded to WhatsApp as sent.

{ "success": true }
Status code Cause
400 VALIDATION_ERROR The body isn’t valid JSON
401 UNAUTHORIZED Missing, wrong or disabled API key
404 NOT_FOUND No such template in your organization
409 ACCOUNT_NOT_REGISTERED The WABA has no active, registered number
422 META_REJECTED WhatsApp rejected the edit. meta_error carries Meta’s own error detail.