---
title: "Delete a phone number business username"
method: DELETE
path: "/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/businessUsername"
tags: ["WhatsApp Phone Numbers"]
---

# Delete a phone number business username

`DELETE /whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/businessUsername`

Deletes the active Business Username for a WhatsApp business phone number.
This operation removes the currently active Business Username. It does not cancel or remove a reserved Business Username request. If a reserved request still exists after deletion, the returned `businessUsernameStatus` remains `reserved`; otherwise it becomes `not_set`.

## Path parameters

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

## Response `200`

Successfully deleted the business username.

- WhatsappBusinessUsernameDeleteResult — Business Username deletion result. Deleting the active username does not cancel a reserved Business Username request. If a reserved request still exists, the returned `businessUsernameStatus` is `reserved`; otherwise it is `not_set`.
  - `success` boolean — Whether the delete request was accepted.
  - `id` string — Phone number ID.
  - `wabaId` string — WhatsApp Business Account ID.
  - `phoneNumber` string — Phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format.
  - `businessUsernameStatus` 'not_set' | 'active' | 'pending_review' | 'reserved' — Business Username state for a WhatsApp business phone number. - `not_set`: No active or pending Business Username exists. - `active`: A Business Username is active. - `reserved`: A requested Business Username is reserved by Meta and may still be under review. - `pending_review`: Legacy compatibility value for an under-review request. New writes use `reserved`. If an active username exists while a new request is reserved or under review, `businessUsernameStatus` is `reserved`, `businessUsername` contains the still-active username, and `requestedBusinessUsername` contains the requested username.
  - `businessUsernameUpdatedAt` string, date-time — The time when the Business Username state was last updated.

## 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)