---
title: "POST /channels"
method: POST
path: "/channels"
---

# POST /channels

`POST /channels`

Creates a channel to which you can add users and send messages.

**Restriction**: You can't change a channel's privacy.

The `x-amz-chime-bearer` request header is mandatory. Use the `AppInstanceUserArn` of the user that makes the API call as the value in the header.

## Headers

- `x-amz-chime-bearer` string

## Request body

- object
  - `AppInstanceArn` string, required — The ARN of the channel request.
  - `Name` string, password, required — The name of the channel.
  - `Mode` 'UNRESTRICTED' | 'RESTRICTED' — The channel mode: <code>UNRESTRICTED</code> or <code>RESTRICTED</code>. Administrators, moderators, and channel members can add themselves and other members to unrestricted channels. Only administrators and moderators can add members to restricted channels.
  - `Privacy` 'PUBLIC' | 'PRIVATE' — The channel's privacy level: <code>PUBLIC</code> or <code>PRIVATE</code>. Private channels aren't discoverable by users outside the channel. Public channels are discoverable by anyone in the <code>AppInstance</code>.
  - `Metadata` string, password — The metadata of the creation request. Limited to 1KB and UTF-8.
  - `ClientRequestToken` string, password, required — The client token for the request. An <code>Idempotency</code> token.
  - `Tags` Tag[] — The tags for the creation request.
    - `Key` string, password, required — The key of the tag.
    - `Value` string, password, required — The value of the tag.

## Response `201`

Success

- CreateChannelResponse
  - `ChannelArn` string — The ARN of the channel.

## Other responses

- `480` — BadRequestException
- `481` — ForbiddenException
- `482` — UnauthorizedClientException
- `483` — ConflictException
- `484` — ResourceLimitExceededException
- `485` — ThrottledClientException
- `486` — ServiceUnavailableException
- `487` — ServiceFailureException

---

[API](https://skmtc.net/aws/apis/chime.md) · [All operations](https://skmtc.net/aws/apis/chime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime/versions/40da18840201/schema)