---
title: "Update a phone number display name"
method: PATCH
path: "/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/displayName"
tags: ["WhatsApp Phone Numbers"]
---

# Update a phone number display name

`PATCH /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/displayName`

Updates a WhatsApp business phone number display name.

## Path parameters

- `wabaId` string, required
- `phoneNumber` string, required

## Request body

- WhatsappPhoneNameUpdateRequest — WhatsApp Phone Number Display Name
  - `newName` string — The new name you want to modify

## Response `200`

Successfully updated the object.

- WhatsappPhoneNameUpdateResponse — WhatsApp Phone Number Display Name Modify Result
  - `verifiedName` string — The verified name
  - `nameStatus` 'APPROVED' | 'AVAILABLE_WITHOUT_REVIEW' | 'DECLINED' | 'EXPIRED' | 'PENDING_REVIEW' | 'NONE' — The review status of the current display name request. See also [Get Display Name Status](https://developers.facebook.com/docs/whatsapp/business-management-api/manage-phone-numbers#get-display-name-status--beta-). - `APPROVED`: The name has been approved. You can download your certificate now. - `AVAILABLE_WITHOUT_REVIEW`: The certificate for the phone is available and display name is ready to use without review. - `DECLINED`: The name has not been approved. You cannot download your certificate. - `EXPIRED`: Your certificate has expire and can no longer be downloaded. - `PENDING_REVIEW`: Your name request is under review. You cannot download your certificate. - `NONE`: No certificate is available.
  - `newName` string — The new name you want to modify
  - `newNameStatus` 'APPROVED' | 'AVAILABLE_WITHOUT_REVIEW' | 'DECLINED' | 'EXPIRED' | 'PENDING_REVIEW' | 'NONE' — The review status of the current display name request. See also [Get Display Name Status](https://developers.facebook.com/docs/whatsapp/business-management-api/manage-phone-numbers#get-display-name-status--beta-). - `APPROVED`: The name has been approved. You can download your certificate now. - `AVAILABLE_WITHOUT_REVIEW`: The certificate for the phone is available and display name is ready to use without review. - `DECLINED`: The name has not been approved. You cannot download your certificate. - `EXPIRED`: Your certificate has expire and can no longer be downloaded. - `PENDING_REVIEW`: Your name request is under review. You cannot download your certificate. - `NONE`: No certificate is available.

## Other responses

- `404` — The requested resource does not exist.

---

[API](https://skmtc.dev/ycloud/apis/ycloud-api.md) · [All operations](https://skmtc.dev/ycloud/apis/ycloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ycloud/ycloud-api/revisions/4e13d3ca9df8/schema)