---
title: "Delete template"
method: DELETE
path: "/v1/whatsapp/templates/{templateName}"
tags: ["WhatsApp"]
---

# Delete template

`DELETE /v1/whatsapp/templates/{templateName}`

Permanently delete a message template.

**Without `language` this deletes every language variant of the name** (Meta's own
contract for deletion by name). Pass `language` to delete one variant only; the response
`scope` says which happened. Meta keeps a deleted approved template in `PENDING_DELETION`
for a while and the name cannot be reused for 30 days.

## Path parameters

- `templateName` string, required

## Query parameters

- `accountId` string, required
- `language` string

## Response `200`

Template deleted successfully

- object
  - `success` boolean
  - `scope` 'all_languages' | 'language' — Whether the whole family or one variant was deleted.
  - `language` string — The deleted variant; only when scope is language.
  - `message` string

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Account not found, or (with language) no such variant (code template_not_found).
- `409` — Only with language: a bare code (es) matched several regional variants (es_ES, es_MX), so nothing was deleted (code ambiguous_template). Without language there is no 409: the whole family is deleted.
- `502` — Meta rejected the request or was unreachable. Meta 4xx statuses are forwarded as-is.

## Changes

- **2026-08-29** `e6f7a453bfb1` — 1 breaking, 5 info
  - removed the media type `application/json` for the response with the status `404`
  - added the new optional `query` request parameter `language`
  - added the media type `application/json` for the response with the status `400`
  - added the non-success response with the status `409`
  - …2 more

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/whatsapp/templates/:templateName/delete.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/62bd668e6eb6/schema)