---
title: "Delete a WhatsApp Template"
slug: "delete-a-whatsapp-template"
description: "Documents the DELETE /api/v1/templates/{id} endpoint for soft-deleting a WhatsApp template locally and removing it from Meta, with request and response format."
updated: 2026-11-02T11:51:42Z
published: 2026-11-02T11:51:42Z
canonical: "academy.insiderone.com/delete-a-whatsapp-template"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://academy.insiderone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete a WhatsApp Template

You can use the WhatsApp Template Management API to soft-delete the selected WhatsApp template locally and, when possible, remove it from Meta. You can use this API version when authenticating requests with an Insider One API key.

> [!NOTE]
> All examples below use sample data and payloads for documentation purposes only. Before going live, replace all template names, languages, components, and media handles with values specific to your own integration.

> [!WARNING]
> For the V1 template API, authenticate requests with `x-ins-auth-key` . Public examples below use the Gateway base URL so that your integration stays on a public entrypoint instead of calling internal services.

> [!NOTE]
> Deleting a template is different from archiving it. Insider One archives templates with no activity for **12 months**, and you can restore an archived template within **28 days**. Refer to [Restore an Archived WhatsApp Template](https://academy.insiderone.com/docs/restore-an-archived-whatsapp-template) to restore an archived template.

## Endpoint and Headers

> **DELETE** https://whatsapp.useinsider.com/v1/templates/42

| Header | Sample Value | Description |
| --- | --- | --- |
| X-INS-AUTH-KEY | 1a2b3c4d5e6f | This key is required to authorize your request. Refer to [Generate API Credentials for WhatsApp Template Management](/v1/docs/generate-api-credentials-for-whatsapp-template-management#generate-whatsapp-template-creation-api-key) to generate your token. |
| Content-Type | application/json | This header specifies the media type of the resource. |

## Body Parameters

| Column | Data Type | Required | Description |
| --- | --- | --- | --- |
| name | String | Yes | The template name to create. |
| language | String | Yes | The template locale, such as **en_US**. |
| category | String | Yes | The Meta template category. |
| components | Array[object] | Yes | At least one component is required. |
| bid_spec | Object | No | Opt-in for dynamic pricing. Only valid for MARKETING templates. |

## Sample Request

```bash
curl --location --request DELETE 'https://whatsapp.useinsider.com/v1/templates/42' \
--header 'x-ins-auth-key: your-api-key'
```

## Sample Response

A successful request returns the following JSON response.

```json
{
  "message": "template deleted"
}
```