Skip to content

Delete a template

There are two ways to delete, matching Meta’s own two delete endpoints.

DELETE /v1/templates/{template_id} deletes a single template object (one name, one language) on WhatsApp and here.

Terminal window
curl -X DELETE "$HELLO_API_URL/v1/templates/1234567890123456" \
-H "Authorization: Bearer $HELLO_API_KEY"

DELETE /v1/{waba_id}/templates?name=<name> deletes every language WhatsApp has for that name, and every matching row here — this mirrors what deleting by name does on Meta’s own API.

Terminal window
curl -X DELETE "$HELLO_API_URL/v1/<your-waba-id>/templates?name=order_shipped" \
-H "Authorization: Bearer $HELLO_API_KEY"
Query parameter Type Required Description
name string Yes Template name
{ "success": true }

If WhatsApp refuses the delete, nothing is removed locally either — a later sync will still reflect whatever WhatsApp actually has.

Status code Cause
400 VALIDATION_ERROR name wasn’t given (name-based delete)
401 UNAUTHORIZED Missing, wrong or disabled API key
404 NOT_FOUND No such template or WABA in your organization
409 ACCOUNT_NOT_REGISTERED The WABA has no active, registered number
422 META_REJECTED WhatsApp refused the delete