---
title: "Create group"
method: POST
path: "/groups"
tags: ["Groups"]
---

# Create group

`POST /groups`

This method is responsible for creating a group with its respective participants. Just like WhatsApp you will need to add at least one contact to be able to create a group. Due to WhatsApp's anti-spam policy, some contacts are not automatically added to the group. [Read more here](https://support.whapi.cloud/help-desk/groups/add-new-member-to-group)

## Request body

- CreateGroupRequest
  - `subject` string, required
  - `participants` ContactID[], required

## Response `200`

- GroupCreate
  - `id` string, required — Chat ID
  - `name` string, required — Group name
  - `type` 'group' | 'contact' | 'broadcast' | 'newsletter' | 'unknown', required — Chat type
  - `timestamp` integer — Chat timestamp
  - `participants` Participant[], required — Group participants
    - `id` string, required — Contact ID
    - `rank` 'admin' | 'member' | 'creator', required — Participant rank
  - `name_at` integer — Group name set timestamp
  - `created_at` integer — Group creation timestamp
  - `created_by` string — Contact ID
  - `unprocessed_participants` ContactID[] — Сontacts that could not be added to the group

## Other responses

- `400` — Wrong request parameters
- `401` — Need channel authorization for create group
- `404` — Specified participant not found in contacts list
- `429` — Too many requests
- `500` — Internal Error

---

[API](https://skmtc.net/whapi/apis/whatsapp-api.md) · [All operations](https://skmtc.net/whapi/apis/whatsapp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whapi/whatsapp-api/versions/40ab05abffdb/schema)