{
"success": true,
"id": "1234567890123456",
"wabaId": "whatsapp-business-account-id",
"phoneNumber": "+16315551111",
"businessUsernameStatus": "not_set",
"businessUsernameUpdatedAt": "2026-05-26T12:00:00.000Z"
}{
"error": {
"status": 404,
"code": "NOT_FOUND",
"message": "The requested resource does not exist.",
"target": "",
"docUrl": "",
"requestId": "req_1KjtKI80IKoaJNa6n6p",
"whatsappApiError": {
"message": "HSM Template creation failed",
"code": 200002,
"type": "OAuthException",
"is_transient": false,
"error_subcode": 2388109,
"error_user_msg": "This message template cannot be created.",
"error_user_title": "Message Cannot Be Submitted",
"fbtrace_id": "AVGjJ7ia2zJkrHG",
"error_data": "<string>"
},
"metaBusinessAgentApiError": {
"title": "<string>",
"detail": "<string>",
"type": "<string>",
"status": 123,
"requestId": "<string>"
}
}
}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.
{
"success": true,
"id": "1234567890123456",
"wabaId": "whatsapp-business-account-id",
"phoneNumber": "+16315551111",
"businessUsernameStatus": "not_set",
"businessUsernameUpdatedAt": "2026-05-26T12:00:00.000Z"
}{
"error": {
"status": 404,
"code": "NOT_FOUND",
"message": "The requested resource does not exist.",
"target": "",
"docUrl": "",
"requestId": "req_1KjtKI80IKoaJNa6n6p",
"whatsappApiError": {
"message": "HSM Template creation failed",
"code": 200002,
"type": "OAuthException",
"is_transient": false,
"error_subcode": 2388109,
"error_user_msg": "This message template cannot be created.",
"error_user_title": "Message Cannot Be Submitted",
"fbtrace_id": "AVGjJ7ia2zJkrHG",
"error_data": "<string>"
},
"metaBusinessAgentApiError": {
"title": "<string>",
"detail": "<string>",
"type": "<string>",
"status": 123,
"requestId": "<string>"
}
}
}Authorizations
Path Parameters
WhatsApp Business Account ID.
"whatsapp-business-account-id"
Response
Successfully deleted the business username.
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.
Whether the delete request was accepted.
true
Phone number ID.
"1234567890123456"
WhatsApp Business Account ID.
"whatsapp-business-account-id"
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 usereserved. If an active username exists while a new request is reserved or under review,businessUsernameStatusisreserved,businessUsernamecontains the still-active username, andrequestedBusinessUsernamecontains the requested username.
not_set, active, pending_review, reserved The time when the Business Username state was last updated.
"2026-05-26T12:00:00.000Z"