---
title: "Create a group chat"
method: POST
path: "/chat-app/chats/group"
tags: ["💬 Chat App"]
---

# Create a group chat

`POST /chat-app/chats/group`

This API endpoint enables a logged-in user to initiate the creation of a group chat, bringing together multiple participants to engage in collaborative discussions.

To establish a group, a minimum of three participants is required.

This endpoint streamlines the process of forming dynamic group conversations, fostering enriched interactions among users within the chat application.

## Request body

- object
  - `name` string
  - `participants` string[]

## Response `201`

Create a group chat

- object
  - `data` object
    - `__v` number
    - `_id` string
    - `admin` string
    - `createdAt` string
    - `isGroupChat` boolean
    - `name` string
    - `participants` object[]
      - `__v` number
      - `_id` string
      - `avatar` object
        - `_id` string
        - `localPath` string
        - `url` string
      - `createdAt` string
      - `email` string
      - `isEmailVerified` boolean
      - `loginType` string
      - `role` string
      - `updatedAt` string
      - `username` string
    - `updatedAt` string
  - `message` string
  - `statusCode` number
  - `success` boolean

## Other responses

- `422` — Minimum 2 participants required

---

[API](https://skmtc.net/hiteshchoudhary-ssesph/apis/freeapi.md) · [All operations](https://skmtc.net/hiteshchoudhary-ssesph/apis/freeapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiteshchoudhary-ssesph/freeapi/revisions/a9f3a290e4dc/schema)