---
title: "Remove group participants"
method: POST
path: "/whatsapp/groups/{groupId}/participants/remove"
tags: ["WhatsApp Groups"]
---

# Remove group participants

`POST /whatsapp/groups/{groupId}/participants/remove`

Removes one or more participants from a WhatsApp group.

The request is processed asynchronously. Use webhooks to receive the final participants update result.

## Path parameters

- `groupId` string, required

## Request body

- WhatsappGroupRemoveParticipantsRequest
  - `participants` WhatsappGroupRemoveParticipant[], required — Participants to remove. Up to 8 participants are supported in one request.
    - `user` string — WhatsApp user ID to remove.
    - `fromUserId` string — Business-scoped user ID to remove. Also accepts `userId` as an alias.

## Response `200`

The participant removal request is successfully accepted.

- WhatsappGroupAsyncResponse — Response for asynchronous WhatsApp group operations.
  - `requestId` string — The request ID for tracking the asynchronous operation in webhooks.
  - `status` 'pending' — The asynchronous request status.

## Other responses

- `400` — Bad request. Invalid request parameters.

---

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