WhatsApp Business Account Users

Remove User from WhatsApp Business Account

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.

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

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

WhatsApp-Business-Account-IDstring required

Your WhatsApp Business Account ID. This ID is provided when you create the account and can be found in your Business Manager or through account management APIs.

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Request body application/x-www-form-urlencoded

userstring 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.

Example request

{
  "user": "2345678901234567"
}

Response

Successfully removed user from WhatsApp Business Account

successboolean required

Operation success status

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 5 revisions of this API.