---
title: "Create Group"
method: POST
path: "/{Version}/{Phone-Number-ID}/groups"
---

# Create Group

`POST /{Version}/{Phone-Number-ID}/groups`

## Request

- Base URL: `https://graph.facebook.com`
- URL: `https://graph.facebook.com/{Version}/{Phone-Number-ID}/groups`
- Auth: HTTP bearer

Create a new group and get an invite link

## Path parameters

- `Version` string, required
- `Phone-Number-ID` string, required

## Headers

- `User-Agent` string
- `Authorization` string, required
- `Content-Type` 'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data', required

## Request body

- object
  - `messaging_product` 'whatsapp', required: Messaging product
  - `subject` string, required: Group subject. Maximum 128 characters. Whitespace is trimmed.
  - `description` string: Group description. Maximum 2048 characters.
  - `join_approval_mode` 'approval_required' | 'auto_approve': Indicates if WhatsApp users who click the invitation link can join the group with or without being approved first. - approval_required: WhatsApp users must be approved via join request before they can access the group - auto_approve: WhatsApp users can join the group without approval

## Response `200`

Group creation request submitted successfully

- object
  - `messaging_product` string
  - `request_id` string: Group creation request ID

## Other responses

- `400`: Bad Request - Invalid request parameters
- `401`: Unauthorized - Invalid or missing access token
- `500`: Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)