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

# POST /groups

`POST /groups`

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

## 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

- **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`
- **2019-07-05** `6956f2622a20` — 8 info
  - api operation id `createGroup` removed and replaced with ``
  - the endpoint scheme security `traqOAuth2` was added to the API
  - endpoint reactivated
  - added optional request body
  - …4 more

[Change 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/66a69a1387ed/schema)