---
title: "POST /groups"
method: POST
path: "/groups"
tags: ["user group"]
deprecated: true
---

# POST /groups

`POST /groups`

> **Deprecated.**

ユーザーグループを作成します

## Request body

- PostUserGroup
  - `name` string, required — グループ名
  - `description` string — 説明

## Response `201`

正常に作成できました

- UserGroup
  - `groupId` string, uuid — グループUUID
  - `name` string — グループ名
  - `description` string — グループ説明
  - `type` string — グループタイプ
  - `adminUserId` string, uuid — グループ管理者UUID
  - `members` string[] — UUIDの配列
  - `createdAt` string, date-time — グループ作成日時
  - `updatedAt` string, date-time — グループ更新日時

## Other responses

- `400` — 正常に作成できませんでした。リクエスト内容が不正です
- `409` — 正常に作成できませんでした。既に存在するグループ名です

## Changes

- **2020-03-18** `78d32137c921` — 1 info
  - endpoint deprecated
- **2019-09-09** `f291e1b35a23` — 1 breaking
  - request body became required
- **2019-07-26** `9d0507aace8d` — 1 info
  - api operation id `createGroups` removed and replaced with `createGroup`
- **2019-07-24** `66a69a1387ed` — 1 info
  - api operation id `createGroups` was added
- **2019-07-22** `d2f7470b1a57` — 1 warning
  - the `name` request property's maxLength was set to `30`

[Full history](https://skmtc.dev/traptitech/apis/traq-api/changes/groups/post.md)

---

[API](https://skmtc.dev/traptitech/apis/traq-api.md) · [All operations](https://skmtc.dev/traptitech/apis/traq-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/traptitech/traq-api/revisions/668d3910e906/schema)