Getting started
Operate
Webhooks
Phone Numbers
Broadcasts
Messages
Conversations
Display Names
Media
Webhook Deliveries
API Logs
Provider Models
WhatsApp Flows
Display Names
Submit display name request
Request a display name change. Meta reviews most changes within 24-48 hours. Some names may be approved instantly.
POST
/
whatsapp
/
phone_numbers
/
{phone_number_id}
/
display_name_requests
curl --request POST \
--url https://api.kapso.ai/platform/v1/whatsapp/phone_numbers/{phone_number_id}/display_name_requests \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"display_name_request": {
"new_display_name": "Acme Support"
}
}
'
{
"data": {
"id": "2b0f4a1e-7a58-4a15-b0c9-0d7f1a2b3c4d",
"phone_number_id": "1234567890",
"requested_display_name": "Acme Support",
"previous_display_name": "+1 555-123-4567",
"status": "pending_review",
"submitted_at": "2025-07-14T15:00:00Z",
"reviewed_at": null,
"applied_at": null,
"meta_error_code": null,
"meta_error_subcode": null,
"meta_error_type": null,
"meta_error_message": null
}
}
Was this page helpful?
Previous
Retrieve display name requestCheck status of a display name change request. Poll this endpoint to monitor Meta's review progress.
Next
⌘I
curl --request POST \
--url https://api.kapso.ai/platform/v1/whatsapp/phone_numbers/{phone_number_id}/display_name_requests \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"display_name_request": {
"new_display_name": "Acme Support"
}
}
'
{
"data": {
"id": "2b0f4a1e-7a58-4a15-b0c9-0d7f1a2b3c4d",
"phone_number_id": "1234567890",
"requested_display_name": "Acme Support",
"previous_display_name": "+1 555-123-4567",
"status": "pending_review",
"submitted_at": "2025-07-14T15:00:00Z",
"reviewed_at": null,
"applied_at": null,
"meta_error_code": null,
"meta_error_subcode": null,
"meta_error_type": null,
"meta_error_message": null
}
}