> ## Documentation Index
> Fetch the complete documentation index at: https://whatsapp-docs.kap.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk management

# Bulk management

Updated: Nov 10, 2025

Use the [POST /\<WABA\_ID>/upsert\_message\_templates](https://developers.facebook.com/docs/graph-api/reference/whats-app-business-account/upsert_message_templates#Creating) endpoint to bulk update or create authentication templates in multiple languages that include or exclude the optional security and expiration warnings.

If a template already exists with a matching name and language, the template will be updated with the contents of the request, otherwise, a new template will be created.

### Request syntax

```
POST /&lt;WHATSAPP_BUSINESS_ACCOUNT_ID&gt;/upsert_message_templates
```

### Post Body

```
\{
  "name": "&lt;NAME&gt;",
  "languages": [&lt;LANGUAGES&gt;],
  "category": "AUTHENTICATION",
  "components": [\
    {\
      "type": "BODY",\
      "add_security_recommendation": &lt;ADD_SECURITY_RECOMMENDATION&gt; // Optional\
    },\
    {\
      "type": "FOOTER",\
      "code_expiration_minutes": &lt;CODE_EXPIRATION_MINUTES&gt; // Optional\
    },\
    {\
      "type": "BUTTONS",\
      "buttons": [\
        {\
          "type": "OTP",\
          "otp_type": "&lt;OTP_TYPE&gt;",\
          "supported_apps": [\
            {\
              "package_name": "&lt;PACKAGE_NAME&gt;", // One-tap and zero-tap buttons only\
              "signature_hash": "&lt;SIGNATURE_HASH&gt;" // One-tap and zero-tap buttons only\
            }\
          ]\
        }\
      ]\
    }\
  ]
}
```

### Properties

All [template creation properties](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates#properties) are supported, with these exceptions:

The `language` property is not supported. Instead, use `languages` and set its value to an array of [language and locale code](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages) strings. For example: `["en_US","es_ES","fr"]`.
The `text` property is not supported.
The `autofill_text` property is not supported.

### Example copy code request

This example creates three authentication templates in English, Spanish, and French, with copy code buttons. Each template is named “authentication\_code\_copy\_code\_button” and includes the security recommendation and expiration time.

```
curl 'https://graph.facebook.com/v24.0/102290129340398/upsert_message_templates' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
\{
  "name": "authentication_code_copy_code_button",
  "languages": ["en_US","es_ES","fr"],
  "category": "AUTHENTICATION",
  "components": [\
    {\
      "type": "BODY",\
      "add_security_recommendation": true\
    },\
    {\
      "type": "FOOTER",\
      "code_expiration_minutes": 10\
    },\
    {\
      "type": "BUTTONS",\
      "buttons": [\
        {\
          "type": "OTP",\
          "otp_type": "COPY_CODE"\
        }\
      ]\
    }\
  ]
}'
```

### Example one-tap autofill request

This example (1) updates an existing template with the name “authentication\_code\_autofill\_button” and language “en\_US”, and (2) creates two new authentication templates in Spanish and French with one-tap autofill buttons. Both newly created templates are named “authentication\_code\_autofill\_button” and include the security recommendation and expiration time.

```
curl 'https://graph.facebook.com/v24.0/102290129340398/upsert_message_templates' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
\{
  "name": "authentication_code_autofill_button",
  "languages": ["en_US","es_ES","fr"],
  "category": "AUTHENTICATION",
  "components": [\
    {\
      "type": "BODY",\
      "add_security_recommendation": true\
    },\
    {\
      "type": "FOOTER",\
      "code_expiration_minutes": 15\
    },\
    {\
      "type": "BUTTONS",\
      "buttons": [\
        {\
          "type": "OTP",\
          "otp_type": "ONE_TAP",\
          "supported_apps": [\
            {\
              "package_name": "com.example.luckyshrub",\
              "signature_hash": "K8a/AINcGX7"\
            }\
          ]\
        }\
      ]\
    }\
  ]
}'
```

### Example response

```
\{
  "data": [\
    {\
      "id": "954638012257287",\
      "status": "APPROVED",\
      "language": "en_US"\
    },\
    {\
      "id": "969725527415202",\
      "status": "APPROVED",\
      "language": "es_ES"\
    },\
    {\
      "id": "969725530748535",\
      "status": "APPROVED",\
      "language": "fr"\
    }\
  ]
}
```

Did you find this page helpful?

![Thumbs up icon](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)

![Thumbs down icon](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

ON THIS PAGE

Request syntax

Post Body

Properties

Example copy code request

Example one-tap autofill request

Example response

***