Call permission request message template | Developer Documentation
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/<API_VERSION>/<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"name": "sample_cpr_template",
"language": "en",
"category": "<CATEGORY>",
"components": [
{
"type": "BODY",
"text": "We would like to call you to help support your order.",
},
{
"type": "call_permission_request"
}
]
}'
Request parameters
| Placeholder | Description | Example Value |
|---|---|---|
<ACCESS_TOKEN>String | Required. | |
<API_VERSION>String | Optional. Graph API version. | v25.0 |
<CATEGORY> | Required. Template category Marketing or Utility | Marketing |
<WHATSAPP_BUSINESS_ACCOUNT_ID> | Required. WhatsApp business account ID. | 106540352242922 |
Response syntax
{
"id": "<ID>",
"status": "<STATUS>",
"category": "<CATEGORY>"
}
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/<API_VERSION>/<PHONE_NUMBER_ID>/messages' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"recipient_type": "individual",
"to": "<WHATSAPP_USER_PHONE_NUMBER>",
"type": "template",
"template": {
"name": "<TEMPLATE_NAME>",
"language": {
"code": "<LANGUAGE_AND_LOCAL_CODE>"
},
"components": [
{
"type": "body",
"parameters": [
{
"type": "text",
"text": "<BODY_TEXT>"
}
]
}
]
}
}'
Request parameters
| Placeholder | Description | Example Value |
|---|---|---|
<ACCESS_TOKEN>String | Required. | |
<API_VERSION>String | Optional. Graph API version. | v25.0 |
<BODY_TEXT>String | Required. Body text. URLs are automatically hyperlinked. Maximum 4096 characters. | John Smith |
<LANGUAGE_AND_LOCAL_CODE>String | Required. Template language and locale code. | en |
<TEMPLATE_NAME>String | Required. Name of template. | august_promotion |
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>String | Required. WhatsApp business phone number ID. | 106540352242922 |
<WHATSAPP_USER_PHONE_NUMBER>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"
}
]
}
No comments to display
No comments to display