---
title: "Remove User from WhatsApp Business Account"
method: DELETE
path: "/{Version}/{WhatsApp-Business-Account-ID}/assigned_users"
tags: ["WhatsApp Business Account Users"]
---

# Remove User from WhatsApp Business Account

`DELETE /{Version}/{WhatsApp-Business-Account-ID}/assigned_users`

## Request

- Base URL: `https://graph.facebook.com`
- URL: `https://graph.facebook.com/{Version}/{WhatsApp-Business-Account-ID}/assigned_users`
- Auth: HTTP bearer

Remove a user's access from the WhatsApp Business Account. This operation revokes
all permissions and access rights for the specified user on the account.


**Use Cases:**
- Revoke user access when they leave the organization
- Remove temporary access grants
- Clean up user permissions for security compliance
- Manage user lifecycle and access control


**Important Notes:**
- This operation removes ALL permissions for the user on this WhatsApp Business Account
- The user will lose access to all account features and data
- This action cannot be undone - the user must be re-added if access is needed again
- Webhooks may be triggered to notify of user access changes


**Rate Limiting:**
Standard Graph API rate limits apply. Use appropriate retry logic with exponential backoff.

## Path parameters

- `Version` string, required
- `WhatsApp-Business-Account-ID` string, required

## Headers

- `User-Agent` string
- `Authorization` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `user` string, required: User ID of the person to remove from the WhatsApp Business Account. This must be a valid Facebook user ID that is currently assigned to the account.

## Response `200`

Successfully removed user from WhatsApp Business Account

- SuccessResponse: Generic success response
  - `success` boolean, required: Operation success status

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - WhatsApp Business Account ID or User ID does not exist or is not assigned
- `422`: Unprocessable Entity - Request parameters are valid but cannot be processed
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)