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

# POST /channels

`POST /channels`

Creates a new Channel.

## Request body

- object
  - `description` string — A short text description of the Channel.
  - `id` string, required — The ID of the Channel. The ID must be unique within the region and it cannot be changed after a Channel is created.
  - `tags` object — A collection of tags associated with a resource

## Response `200`

Success

- CreateChannelResponse
  - `Arn` string — The Amazon Resource Name (ARN) assigned to the Channel.
  - `CreatedAt` string — The date and time the Channel was created.
  - `Description` string — A short text description of the Channel.
  - `EgressAccessLogs` object — Configure egress access logging.
    - `LogGroupName` string — Customize the log group name.
  - `HlsIngest` object — An HTTP Live Streaming (HLS) ingest resource configuration.
    - `IngestEndpoints` IngestEndpoint[] — A list of endpoints to which the source stream should be sent.
      - `Id` string — The system generated unique identifier for the IngestEndpoint
      - `Password` string — The system generated password for ingest authentication.
      - `Url` string — The ingest URL to which the source stream should be sent.
      - `Username` string — The system generated username for ingest authentication.
  - `Id` string — The ID of the Channel.
  - `IngressAccessLogs` object — Configure ingress access logging.
    - `LogGroupName` string — Customize the log group name.
  - `Tags` object — A collection of tags associated with a resource

## Other responses

- `480` — UnprocessableEntityException
- `481` — InternalServerErrorException
- `482` — ForbiddenException
- `483` — NotFoundException
- `484` — ServiceUnavailableException
- `485` — TooManyRequestsException

---

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