---
title: "Create a group"
method: POST
path: "/whatsapp/{businessPhoneNumber}/groups"
tags: ["WhatsApp Groups"]
---

# Create a group

`POST /whatsapp/{businessPhoneNumber}/groups`

Creates a WhatsApp group for the specified business phone number.

The request is processed asynchronously. Use webhooks to receive the final group lifecycle result.

## Path parameters

- `businessPhoneNumber` string, required

## Request body

- WhatsappGroupCreateRequest
  - `subject` string, required — The group subject.
  - `description` string — The group description.
  - `joinApprovalMode` 'approval_required' | 'auto_approve' — WhatsApp group join approval mode. - `approval_required`: New members must be approved before joining. - `auto_approve`: New members can join without approval.

## Response `200`

The group creation 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)