---
title: "Create Group"
method: POST
path: "/chats/create"
tags: ["chats", "group"]
---

# Create Group

`POST /chats/create`

This endpoint creates a new group.
 - Note that creating a new 1-1 chat does not require any explicit API. Sending a message will automatically create the chat

## Headers

- `x-phone` string

## Request body

- object
  - `group_name` string, required — - Provide the name of the group to be created
  - `participants` string[], required — - Provide a list of participants to be added to the group (in country_code + number format). - Participants will be directly added to the group if they are in your phone contacts and their privacy settings allow it. If not, participants will receive an invite to join the group
  - `options` object — - Provide additional options while creating a group
    - `addMembersAdminsOnly` boolean — - When set to true, only admins can add other participants to the group - Default false
    - `description` string — - Provide an optional text input to set the group description
    - `image` string — - Provide a public image URL to set the group image
    - `infoAdminsOnly` boolean — - When set to true, only admins can edit group description or info - Default false
    - `messagesAdminsOnly` boolean — - When set to true, only admins can send messages to the group. - Default false
    - `force_add_participants` boolean — - When set to true, all participants will be attempted to be added directly to group. - Default false

## Response `200`

200 OK

- object — The response is a chat object for the new created group. Refer to [the chat object here](/api-reference/objects/the-chat-object)

---

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