---
title: "Create group"
method: PUT
path: "/group"
tags: ["[v1] Group"]
---

# Create group

`PUT /group`

Add new group. Edit permission is required.


There cannot be more than one root group (with parent_id = 0).
Maximum group tree depth is 4 levels.

If you get an error 403 `You can not change this group` try to wait about one minute and retry.

## Request body

- object
  - `parent_id` union — group parent id
    - string
    - integer
  - `name` string, required — group name

## Response `200`

OK

- object
  - `group_id` union
    - string
    - integer
  - `name` string
  - `admin_id` union
    - string
    - integer
  - `parent_id` union
    - string
    - integer
  - `root_group_id` union
    - string
    - integer

## Other responses

- `403` — Forbidden
- `404` — Not Found

---

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