---
title: "Create Group"
method: POST
path: "/api/v2/groups"
tags: ["Groups"]
---

# Create Group

`POST /api/v2/groups`

#### Allowed For

* Admins
* Agents assigned to a custom role with permissions to manage groups (Enterprise only)

## Request body

- GroupCreateRequest
  - `group` object, required
    - `name` string, required — The name of the group
    - `description` string — The description of the group
    - `is_public` boolean — Whether the group is public

## Response `201`

Created response

- GroupResponse
  - `group` GroupObject
    - `created_at` string, date-time — The time the group was created
    - `default` boolean — If the group is the default one for the account
    - `deleted` boolean — Deleted groups get marked as such
    - `description` string — The description of the group
    - `id` integer — Automatically assigned when creating groups
    - `is_public` boolean — If true, the group is public. If false, the group is private. You can't change a private group to a public group
    - `name` string, required — The name of the group
    - `updated_at` string, date-time — The time of the last update of the group
    - `url` string — The API url of the group

## Changes

> 29 revisions in range; 1 not diffed, 1 could not be searched.

- **2025-06-12** `dd8f9933eaf5` — 2 info
  - added the new optional request property `group/description`
  - added the new optional request property `group/is_public`
- **2025-06-12** `b07f50259d0f` — 1 breaking
  - added required request body

[Change history](https://skmtc.dev/botbrains-io/apis/support-api/changes/api/v2/groups/post.md)

---

[API](https://skmtc.dev/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.dev/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botbrains-io/support-api/revisions/d53eac07ba68/schema)