Bulk management

Updated: Nov 10, 2025 Use the POST /<WABA_ID>/upsert_message_templates 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 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 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

ON THIS PAGE Request syntax Post Body Properties Example copy code request Example one-tap autofill request Example response

Overview

Getting started

Business setup

Messages

Templates

Embedded signup

Flows

Calling

Groups

Payments

Catalogs

Marketing messages

Click to WhatsApp ads

Solution providers

API reference

Pricing

Policies

Other

Support

Bulk management

Bulk management

Request syntax

Post Body

Properties

Example copy code request

Example one-tap autofill request

Example response

​Bulk management

​Request syntax

​Post Body

​Properties

​Example copy code request

​Example one-tap autofill request

​Example response

Bulk management

Request syntax

Post Body

Properties

Example copy code request

Example one-tap autofill request

Example response