# 8. How to Edit display name and delete the Whatsapp API Number ?

### Display Names <a href="#deleting-phone-numbers" id="deleting-phone-numbers"></a>

A business phone number display name is the name that appears in WhatsApp Manager. It can also be displayed in WhatsApp chat thread headers, chat lists, and its profile, if the following conditions are met:

* The business portfolio that owns the WhatsApp Business Account associated with the business phone number has completed [business verification](https://www.facebook.com/business/help/2058515294227817).
* The business phone number's `name_status` is `APPROVED`.

Once the above conditions are met, the business phone number's `verified_name` (Display name in WhatsApp Manager) is displayed.

Note that if a WhatsApp user has edited the business's profile name within the app, its edited name will be displayed instead.

You can set a display name when you add a business phone number in the **App Dashboard** > **WhatsApp** > **API Setup** panel, or in the **WhatsApp Manager** > **Account tools** > **Phone numbers** panel, if you haven't reached your phone number limit.

If you submit your business portfolio for [verification](https://www.facebook.com/business/help/1095661473946872) and it becomes verified, we will either:

* approve your display name
* reject your display name
* ask you to message more

In each case, we will notify you by `phone_number_name_update` webhook and Meta Business Suite notification.

If approved, we will set your business phone number's `name_status` to `APPROVED`.

If rejected, we will set your business phone number's `name_status` to `DECLINED`. We recommend that you re-review our [display name guidelines](https://www.facebook.com/business/help/757569725593362), [edit your display name](https://www.facebook.com/business/help/378834799515077) accordingly, and file an appeal via [Developer Support](https://developers.facebook.com/docs/whatsapp/support#developer-support) or [Enterprise Developer Support](https://developers.facebook.com/docs/whatsapp/support#enterprise-developer-support).

If asked to message more, we don't have enough API usage data to determine if your number warrants a display name. Continue using the API, [monitor phone number and message quality](https://developers.facebook.com/docs/whatsapp/guides/how-to-monitor-quality-signals) and take appropriate actions to improve your quality scores, and we will automatically re-review your display name at a future date.\
&#x20;

Deleting Phone Numbers

#### Limitations <a href="#limitations" id="limitations"></a>

* Only an admin for the business portfolio can delete its business phone numbers.
* A number can't be deleted if it has been used to send paid messages within the last 30 days.
* If the number has been used to send paid messages within the last 30 days, you will be redirected to the Insights page showing the date of the last paid message. You can delete the number 30 days from this date.

To delete a registered business phone number:

1. Load your business portfolio in the [WhatsApp Manager](https://developers.facebook.com/docs/whatsapp/cloud-api/overview#whatsapp-manager).
2. If it doesn't automatically load the **Phone numbers** panel, navigate to **Account tools** (the toolbox icon) > **Phone numbers**.
3. Click the phone number's trash can icon and complete the flow.

You may be asked to provide your password if the phone number has a **Connected** status.

{% hint style="info" %}
Kindly refer the below for better understanding
{% endhint %}

{% embed url="<https://www.loom.com/share/b38e4e8dafbb4396a8b74c13681ba539?sid=038b2cf3-8c3d-4880-a734-9dddaf600b06>" %}
Display name and Deleting the Whatsapp API Number
{% endembed %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.whatstool.business/meta-guide/q-and-a-best-practices/8.-how-to-edit-display-name-and-delete-the-whatsapp-api-number.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
