---
title: "Update group settings"
method: PATCH
path: "/whatsapp/{businessPhoneNumber}/groups/{groupId}/settings"
tags: ["WhatsApp Groups"]
---

# Update group settings

`PATCH /whatsapp/{businessPhoneNumber}/groups/{groupId}/settings`

Updates a WhatsApp group's settings, such as subject or description.

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

## Path parameters

- `businessPhoneNumber` string, required
- `groupId` string, required

## Request body

- WhatsappGroupUpdateSettingsRequest — Contains the group settings to update. At least one of `subject` or `description` is required.
  - `subject` string — The group subject.
  - `description` string — The group description.

## Response `200`

The group settings update 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)