---
title: "POST /channels"
method: POST
path: "/channels"
tags: ["channel"]
---

# POST /channels

`POST /channels`

チャンネルを作成します。

## Request body

- CreateChannel
  - `private` boolean — プライベートチャンネルかどうか
  - `member` string[] — UUIDの配列
  - `name` string — チャンネル名
  - `parent` string, uuid — 親のチャンネルID

## Response `201`

正常にチャンネルが作成できました。
作成されたチャンネルを返します。

- Channel
  - `channelId` string, uuid — チャンネルUUID
  - `name` string — チャンネル名
  - `member` string[] — UUIDの配列
  - `parent` string, uuid — 親の階層のチャンネルUUID
  - `topic` string — チャンネルトピック
  - `children` string[] — UUIDの配列
  - `visibility` boolean — チャンネルの可視状態
  - `force` boolean — 強制通知チャンネルか
  - `private` boolean — プライベートチャンネルか
  - `dm` boolean — ダイレクトメッセージチャンネルか

## Other responses

- `400` — +| 正常にチャンネルが作成できませんでした。 親チャンネルが存在しない又は指定されたタイプに対して適切なプロパティが存在しません。

## Changes

- **2019-09-09** `f291e1b35a23` — 1 breaking
  - request body became required
- **2019-07-24** `66a69a1387ed` — 1 info
  - api operation id `createChannel` was added
- **2019-07-05** `6956f2622a20` — 7 info
  - api operation id `createChannel` removed and replaced with ``
  - the endpoint scheme security `traqOAuth2` was added to the API
  - endpoint reactivated
  - added optional request body
  - …3 more

[Change history](https://skmtc.dev/traptitech/apis/traq-api/changes/channels/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/801af87793dd/schema)