---
title: "Create Group"
method: POST
path: "/v2/{sid}/whatsapp/{fromNumber}/groups"
tags: ["Groups"]
---

# Create Group

`POST /v2/{sid}/whatsapp/{fromNumber}/groups`

The Create Group API allows you to create WhatsApp groups under a given WhatsApp Business number. The API supports both `auto_approval` and `approval_required modes` for adding participants to the created WhatsApp group.

## Path parameters

- `sid` string, required
- `fromNumber` string, required

## Request body

- object
  - `messaging_product` string, required — To be passed as whatsapp
  - `subject` string, required — Group Name of the WhatsApp Group being created
  - `description` string, required — Description of the WhatsApp Group being created
  - `join_approval_mode` 'auto_approve' | 'approval_required', required — Approval Mode of the end user trying to join the WhatsApp Group. By default, taken as auto_approve and the end user will be able to join the WhatsApp group without any permission from the business. If passed as approval_required, the end user will only be able to request to join the WhatsApp Group. The business has to use Approve/Reject join requests API to allow/disallow the end users to join the WhatsApp Group.

## Response `201`

Group created successfully

- SuccessRequestResponse
  - `code` string
  - `message` string
  - `data` object
    - `messaging_product` string
    - `request_id` string
  - `error` object

## Other responses

- `400` — Phone number validation error
- `401` — Incorrect SID or API key
- `500` — Meta eligibility error

---

[API](https://skmtc.net/kaleyra/apis/kaleyra-io-sms-apis.md) · [All operations](https://skmtc.net/kaleyra/apis/kaleyra-io-sms-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kaleyra/kaleyra-io-sms-apis/versions/d9b785884d03/schema)