---
title: "PUT /channels"
method: PUT
path: "/channels"
tags: ["channels"]
---

# PUT /channels

`PUT /channels`

Create a new Channel in a Heartbeat community

## Request body

- object
  - `name` string, required
  - `description` string
  - `isPrivate` boolean, required
  - `channelCategoryID` string, uuid, required — The id for the category where the channel should be created
  - `invitedUsers` string[] — A list of emails corresponding to the users that can access this channel. If the channel is private, only these users will be able to access the channel. If both invitedUsers & invitedGroups are provided, the lists will be combined.
  - `invitedGroups` string[] — If the channel is private, only these groups will be able to access the channel. If both invitedUsers & invitedGroups are provided, the lists will be combined.
  - `isReadOnly` boolean — If true, only admins & moderators will be able to create threads in this channel. This option is not currently available for chat channels
  - `channelType` 'POSTS' | 'CHAT' — Thread channels are created by default

## Response `200`

Successful response

## Other responses

- `400` — Invalid request body
- `401` — API Key is missing or invalid

---

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