Skip to main content

Call permission request message template

Updated: Nov 3, 2025 Create a call permission request template message that your business can send to users outside of the customer service window.

Create call permission request message template

Request syntax

Use the POST /<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates endpoint to create a call permission request message template.
curl -X POST \
  'https://graph.facebook.com/&lt;API_VERSION&gt;/&lt;WHATSAPP_BUSINESS_ACCOUNT_ID&gt;/message_templates' \
  -H 'Authorization: Bearer &lt;ACCESS_TOKEN&gt;' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "sample_cpr_template",
    "language": "en",
    "category": "&lt;CATEGORY&gt;",
    "components": [\
      {\
        "type": "BODY",\
        "text": "We would like to call you to help support your order.",\
      },\
      {\
        "type": "call_permission_request"\
      }\
   ]
}'

Request parameters

PlaceholderDescriptionExample Value
&lt;ACCESS_TOKEN&gt;
String
Required.
System token or business token.
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
&lt;API_VERSION&gt;
String
Optional.
Graph API version.
v24.0
&lt;CATEGORY&gt;Required.
Template category
Marketing or Utility
Marketing
&lt;WHATSAPP_BUSINESS_ACCOUNT_ID&gt;Required.
Whatsapp business account ID.
106540352242922

Response syntax

\{
  "id": "&lt;ID&gt;",
  "status": "&lt;STATUS&gt;",
  "category": "&lt;CATEGORY&gt;"
}

Send a call permission request message template

Request syntax

Use the POST /<PHONE_NUMBER_ID>/messages endpoint to send a call permission request message template to a WhatsApp user.
curl -X POST \
  'https://graph.facebook.com/&lt;API_VERSION&gt;/&lt;PHONE_NUMBER_ID&gt;/messages' \
  -H 'Authorization: Bearer &lt;ACCESS_TOKEN&gt;' \
  -H 'Content-Type: application/json' \
  -d '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "&lt;WHATSAPP_USER_PHONE_NUMBER&gt;",
    "type": "template",
    "template": {
      "name": "&lt;TEMPLATE_NAME&gt;",
      "language": {
        "code": "&lt;LANGUAGE_AND_LOCAL_CODE&gt;"
      },
      "components": [\
        {\
          "type": "body",\
          "parameters": [\
            {\
              "type": "text",\
              "text": "&lt;BODY_TEXT&gt;"\
            }\
          ]\
        }\
      ]
   }
}'

Request parameters

PlaceholderDescriptionExample Value
&lt;ACCESS_TOKEN&gt;
String
Required.
System token or business token.
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
&lt;API_VERSION&gt;
String
Optional.
Graph API version.
v24.0
&lt;BODY_TEXT&gt;
String
Required.
Body text. URLs are automatically hyperlinked.
Maximum 4096 characters.
John Smith
&lt;LANGUAGE_AND_LOCAL_CODE&gt;
String
Required.
Template language and locale code.
en
&lt;TEMPLATE_NAME&gt;
String
Required.
Name of template.
august_promotion
&lt;WHATSAPP_BUSINESS_PHONE_NUMBER_ID&gt;
String
Required.
WhatsApp business phone number ID.
106540352242922
&lt;WHATSAPP_USER_PHONE_NUMBER&gt;
String
Required.
WhatsApp user phone number.
+16505551234

Example response

\{
   "messaging_product": "whatsapp",
   "contacts": [\
       {\
           "input": "+1233214532",\
           "wa_id": "1233214532"\
       }\
   ],
   "messages": [\
       {\
           "id": "wamid.HBgLMTMyMzI4NjU2NzgVAgARGBJBQzRBRDBEMDEwQzVBM0M0QkIA",\
           "message_status": "accepted"\
       }\
   ]
}
Did you find this page helpful? Thumbs up icon Thumbs down icon ON THIS PAGE Create call permission request message template Request syntax Request parameters Response syntax Send a call permission request message template Request syntax Request parameters Example response