Skip to main content

Template previews | Developer Documentation

Template previews

Updated: Nov 4, 2025
You can generate previews of authentication template text in various languages that include or exclude the security recommendation string and code expiration string using the GET /<WABA_ID>/message_template_previews endpoint.

Request syntax

GET /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_template_previews
  ?category=AUTHENTICATION,
  &language=<LANGUAGE>, // Optional
  &add_security_recommendation=<ADD_SECURITY_RECOMMENDATION>, // Optional
  &code_expiration_minutes=<CODE_EXPIRATION_MINUTES>, // Optional
  &button_types=<BUTTON_TYPES> // Optional

Request parameters

Placeholder Description Example Value
<LANGUAGE>
Comma-separated list
Optional.

Comma-separated list of language and locale codes of language versions you want returned.

If omitted, versions of all supported languages will be returned.
en_US,es_ES
<ADD_SECURITY_RECOMMENDATION>
Boolean
Optional.

Set to true if you want the security recommendation body string included in the response.

If omitted, the security recommendation string will not be included.
true
<CODE_EXPIRATION_MINUTES>
Int64
Optional.

Set to an integer if you want the code expiration footer string included in the response.

If omitted, the code expiration footer string will not be included.

Value indicates number of minutes until code expires.
Minimum 1, maximum 90.
10
<BUTTON_TYPES>
Comma-separated list of strings
Required.

Comma-separated list of strings indicating button type.

If included, the response will include the button text for each button in the response.

For authentication templates, this value must be OTP.
OTP

Example request

curl 'https://graph.facebook.com/v17.0/102290129340398/message_template_previews?category=AUTHENTICATION&languages=en_US,es_ES&add_security_recommendation=true&code_expiration_minutes=10&button_types=OTP' \
-H 'Authorization: Bearer EAAJB...'
Example response
{
  "data": [
    {
      "body": "*{{1}}* is your verification code. For your security, do not share this code.",
      "buttons": [
        {
          "autofill_text": "Autofill",
          "text": "Copy code"
        }
      ],
      "footer": "This code expires in 10 minutes.",
      "language": "en_US"
    },
    {
      "body": "Tu código de verificación es *{{1}}*. Por tu seguridad, no lo compartas.",
      "buttons": [
        {
          "autofill_text": "Autocompletar",
          "text": "Copiar código"
        }
      ],
      "footer": "Este código caduca en 10 minutos.",
      "language": "es_ES"
    }
  ]
}

    
        

        

    

        

            

                
                

                    
                    
                

            

            
            

                                            

        

    


    


    


    
            

            


    

        

            
            
        

            


    

        

                    


        
No comments to display


            


    

    

            

        

                

        

    


    


    
    

        

             Back to top