---
title: "Create Group"
method: POST
path: "/group/create/{instance}"
tags: ["Group Controller"]
---

# Create Group

`POST /group/create/{instance}`

## Request

- Base URL: `https://evolution-example`
- URL: `https://evolution-example/group/create/{instance}`
- Auth: API key in header `apikey`

Create group

## Path parameters

- `instance` string, required

## Request body

- object
  - `subject` object, required: Group subject
  - `description` string, required: Group description
  - `participants` string[], required: Group members phone numbers with country code

## Response `200`

Ok

## Changes

- **2024-11-25** (v2) `6cc9e69eaf4c`: 3 breaking
  - the request property `description` became required
  - the request property `participants` became required
  - the request property `subject` became required
- **2024-11-25** (v2) `c153448703e5`: 1 breaking, 7 info
  - removed the media type `application/json` for the response with the status `200`
  - api operation id `createGroup` was added
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - api tag `Group Controller` added
  - …4 more
- **2024-09-09** (v2) `0c4620ca5ed5`: 3 warning, 5 info
  - removed the request property `description`
  - removed the request property `participants`
  - removed the request property `subject`
  - api operation id `createGroup` removed and replaced with ``
  - …4 more

[Operation history](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/changes/group/create/:instance/post.md)

---

[API](https://skmtc.dev/evolution-foundation/apis/evolution-api-3.md) - [All operations](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/revisions/153363ee7f38?raw)