---
title: "PUT /voiceChannels"
method: PUT
path: "/voiceChannels"
tags: ["voice"]
---

# PUT /voiceChannels

`PUT /voiceChannels`

Create a new voice channel in a Heartbeat community

## Request body

- object
  - `name` string, required
  - `description` string
  - `isPrivate` boolean
  - `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 voice channel. If both invitedUsers & invitedGroups are provided, the lists will be combined.
  - `invitedGroups` string[] — If the voice channel is private, only these groups will be able to access the channel. If both invitedUsers & invitedGroups are provided, the lists will be combined.

## Response `200`

Successful response

## Other responses

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

---

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