Sign in

v1

latestOpenAPI 3.0.02026-07-2491237338.9 KB
WhatsApp Phone Numbers

Delete a phone number business username

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.

delete/whatsapp/phoneNumbers/{wabaId}/{phoneNumber}/businessUsername

Path parameters

wabaIdstring required
Example:whatsapp-business-account-id

WhatsApp Business Account ID.

phoneNumberstring required
Example:+16315551111

Phone number in E.164 format.

Response

Successfully deleted the business username.

successboolean

Whether the delete request was accepted.

idstring

Phone number ID.

wabaIdstring

WhatsApp Business Account ID.

phoneNumberstring

Phone number in 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.
businessUsernameUpdatedAtstring date-time

The time when the Business Username state was last updated.

Example response

{
  "success": true,
  "id": "1234567890123456",
  "wabaId": "whatsapp-business-account-id",
  "phoneNumber": "+16315551111",
  "businessUsernameUpdatedAt": "2026-05-26T12:00:00.000Z"
}