Skip to main content
Permanently delete a WhatsApp Message Template from your project. This action removes the template from Convo and triggers deletion from WhatsApp’s systems.
WhatsApp enforces a 30-day cooldown on deleted template names. After deletion, you cannot submit a new template using the same name for 30 days. Additionally, deleting a template that is actively used in running campaigns will immediately break those sends. Review your active campaigns before deleting any template.

​
Endpoint

​
Authentication

​
Path Parameters

​
string
required
Your Convo project ID.
​
string
required
The unique ID of the WhatsApp Message Template to delete. This is the _id field returned from the Submit Template, List Templates, or Get Template endpoints.

​
Request Example

​
Response

A successful deletion returns 200 OK with a status confirmation.
There is no additional data returned. Once deleted, the template cannot be recovered.

​
What Happens After Deletion

  • The template is immediately removed from your Convo project.
  • WhatsApp deletes the template from their platform, which may take a short time to propagate.
  • Any API campaign linked to this template will fail to send until reconfigured with a different template.
  • The template name is locked for 30 days — you cannot resubmit a template with the same name during this period.
If you want to update a template’s content, the recommended approach is to submit a new template with a versioned name (e.g., shipping_update_v2) rather than deleting and recreating the existing one. This avoids the cooldown period and keeps existing campaigns functional.

​
Error Responses