---
title: "Update OTP Templates"
slug: "update-otp-templates-whatsapp"
description: "Documents the POST /v1/template/update endpoint for updating a WhatsApp OTP template's locale, text, or template name, covering parameters and errors."
tags: ["whatsapp verify api", "whatsapp otp"]
updated: 2026-09-09T13:39:01Z
published: 2026-09-09T13:39:01Z
canonical: "academy.insiderone.com/update-otp-templates-whatsapp"
---

> ## 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.

# Update OTP Templates

Once you create your OTP templates, you may need to revise them over time. This section describes how to update WhatsApp OTP templates already registered in your WhatsApp Business Account.

## Endpoint and Headers

> **POST** https://verify.useinsider.com/v1/template/update [](https://developers.insiderone.com/#f39f862b-7cf9-4eea-a508-1f741922b12e)

> [!WARNING]
> This API key is sensitive and should never be used on the front end or mobile SDK; it should only be implemented on the back end.

> Visit our Postman collection to test this request.

| Header | Sample Value | Description |
| --- | --- | --- |
| X-INS-AUTH-KEY | 1a2b3c4d5e6f | This key is required to authorize your request. Refer to [API Authentication Tokens](https://academy.insiderone.com/docs/api-authentication-tokens) to generate your token. |
| Content-Type | application/json | This header specifies the media type of the resource. |

## Body Parameters

| Parameter | Description | Data Type | Required | Rules |
| --- | --- | --- | --- | --- |
| channel | The channel that you will send the OTP code to. | String | Yes | oneof:whatsapp |
| locale | Determines the language/locale in which the OTP code message will be sent. | String | Yes | oneof:pt af sq ar az bn bg ca zh_CN zh_HK zh_TW hr cs da nl en en_GB en_US et fil fi fr ka de el gu ha he hi hu id ga it ja kn kk rw_RW ko ky_KG lo lv lt mk ms ml mr nb fa pl pt_BR pt_PT pa ro ru sr sk sl es es_AR es_ES es_MX sw sv ta te th tr uk ur uz vi zu |
| text | Defines the template text that will be used for generating OTP code messages. | String | No | max:100 |
| templateName | The name of the WhatsApp Business Account template to be updated. This name must exactly match a template that is already registered in your account. | String | No | - |

## Sample Request

Every request to the request endpoint must include a JSON-formatted request body containing your parameters.

> [!WARNING]
> Make sure to replace the sample values in the request header(s) and body where required before sending your request.

Below is a sample request to update an existing WhatsApp verification template by specifying its locale and template name.

```bash
curl --location 'https://verify.useinsider.com/v1/template/update' \
--header 'Content-Type: application/json' \
--header 'x-ins-auth-key: 1a2b3c4d5e6f' \
--data '{
  "channel": "whatsapp",
  "locale": "en",
  "templateName": "sample_template_name"
}'
```

## Sample Responses

### 202 Accepted

This response indicates that your request was successfully completed.

```json
{
  "status": "success"
}
```

### 400 Bad Request

**Invalid request payload:**

```json
{
  "errors": [
    {
      "message": "invalid request payload"
    }
  ]
}
```

**Missing required field:**

```json
{
  "errors": [
    {
      "message": "this field is required",
      "field": "text"
    }
  ]
}
```

### 401 Unauthorized

```json
{
  "errors": [
    {
      "message": "unauthorized"
    }
  ]
}
```

### 409 Conflict

```json
{
  "errors": [
    {
      "message": "no changes detected"
    }
  ]
}
```

### 429 Too Many Requests

```json
{
  "errors": [
    {
      "message": "rate limit exceeded"
    }
  ]
}
```

### 500 Internal Server Error

```json
{
  "errors": [
    {
      "message": "server error"
    }
  ]
}
```

## Limitations

- All functions must be executed with a simple **HTTPS POST** request.
- The **API Key** should be provided as the authorization key in the request header. If the key is incorrect, the operation will not be executed, and an authorization error will be returned in the response.
- The service is subject to a rate limit of **25 requests per minute** to ensure optimal system performance. If you exceed this limit, you will receive an HTTP **429 Too Many Requests** response.

> The default limit shown here is a standard baseline. If your use case requires higher capacity, feel free to reach out to the Insider One team. We can adjust it to fit your needs.

## Related

- [Create a Channel](/create-a-channel-whatsapp-otp.md)
- [Create an OTP Template from the Template Creation API](/create-otp-template-from-template-creation-api.md)
- [Generate OTP Codes](/generate-otp-codes-whatsapp.md)
- [Generate OTP API Key](/generate-otp-api-key.md)
- [List OTP Templates](/list-otp-templates-whatsapp.md)
- [Verify OTP Codes](/verify-otp-codes-whatsapp.md)
- [API Authentication Tokens](/api-authentication-tokens.md)
- [API Rate Limits](/api-rate-limits.md)
- [API Status and Error Codes](/api-status-and-error-codes.md)
- [Insider One APIs in Postman](/insider-apis-in-postman.md)