---
title: "POST /channel/{ChannelName}"
method: POST
path: "/channel/{ChannelName}"
---

# POST /channel/{ChannelName}

`POST /channel/{ChannelName}`

Creates a channel. For information about MediaTailor channels, see <a href="https://docs.aws.amazon.com/mediatailor/latest/ug/channel-assembly-channels.html">Working with channels</a> in the <i>MediaTailor User Guide</i>.

## Path parameters

- `ChannelName` string, required

## Request body

- object
  - `FillerSlate` object — Slate VOD source configuration.
    - `SourceLocationName` string — The name of the source location where the slate VOD source is stored.
    - `VodSourceName` string — The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate.
  - `Outputs` RequestOutputItem[], required — An object that represents an object in the CreateChannel request.
    - `DashPlaylistSettings` object — DASH manifest configuration parameters.
      - `ManifestWindowSeconds` integer — The total duration (in seconds) of each manifest. Minimum value: <code>30</code> seconds. Maximum value: <code>3600</code> seconds.
      - `MinBufferTimeSeconds` integer — Minimum amount of content (measured in seconds) that a player must keep available in the buffer. Minimum value: <code>2</code> seconds. Maximum value: <code>60</code> seconds.
      - `MinUpdatePeriodSeconds` integer — Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest. Minimum value: <code>2</code> seconds. Maximum value: <code>60</code> seconds.
      - `SuggestedPresentationDelaySeconds` integer — Amount of time (in seconds) that the player should be from the live point at the end of the manifest. Minimum value: <code>2</code> seconds. Maximum value: <code>60</code> seconds.
    - `HlsPlaylistSettings` object — HLS playlist configuration parameters.
      - `ManifestWindowSeconds` integer — The total duration (in seconds) of each manifest. Minimum value: <code>30</code> seconds. Maximum value: <code>3600</code> seconds.
    - `ManifestName` string, required — The name of the manifest for the channel. The name appears in the <code>PlaybackUrl</code>.
    - `SourceGroup` string, required — A string used to match which <code>HttpPackageConfiguration</code> is used for each <code>VodSource</code>.
  - `PlaybackMode` 'LOOP' | 'LINEAR', required — <p>The type of playback mode to use for this channel.</p> <p> <code>LINEAR</code> - The programs in the schedule play once back-to-back in the schedule.</p> <p> <code>LOOP</code> - The programs in the schedule play back-to-back in an endless loop. When the last program in the schedule stops playing, playback loops back to the first program in the schedule.</p>
  - `tags` object — The tags to assign to the channel. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see <a href="https://docs.aws.amazon.com/mediatailor/latest/ug/tagging.html">Tagging AWS Elemental MediaTailor Resources</a>.
  - `Tier` 'BASIC' | 'STANDARD' — The tier of the channel.

## Response `200`

Success

- CreateChannelResponse
  - `Arn` string — The Amazon Resource Name (ARN) to assign to the channel.
  - `ChannelName` string — The name to assign to the channel.
  - `ChannelState` 'RUNNING' | 'STOPPED' — Indicates whether the channel is in a running state or not.
  - `CreationTime` string, date-time — The timestamp of when the channel was created.
  - `FillerSlate` object — Contains information about the slate used to fill gaps between programs in the schedule.
    - `SourceLocationName` string — The name of the source location where the slate VOD source is stored.
    - `VodSourceName` string — The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate.
  - `LastModifiedTime` string, date-time — The timestamp of when the channel was last modified.
  - `Outputs` ResponseOutputItem[] — The output properties to assign to the channel.
    - `DashPlaylistSettings` object — DASH manifest configuration settings.
      - `ManifestWindowSeconds` integer — The total duration (in seconds) of each manifest. Minimum value: <code>30</code> seconds. Maximum value: <code>3600</code> seconds.
      - `MinBufferTimeSeconds` integer — Minimum amount of content (measured in seconds) that a player must keep available in the buffer. Minimum value: <code>2</code> seconds. Maximum value: <code>60</code> seconds.
      - `MinUpdatePeriodSeconds` integer — Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest. Minimum value: <code>2</code> seconds. Maximum value: <code>60</code> seconds.
      - `SuggestedPresentationDelaySeconds` integer — Amount of time (in seconds) that the player should be from the live point at the end of the manifest. Minimum value: <code>2</code> seconds. Maximum value: <code>60</code> seconds.
    - `HlsPlaylistSettings` object — HLS manifest configuration settings.
      - `ManifestWindowSeconds` integer — The total duration (in seconds) of each manifest. Minimum value: <code>30</code> seconds. Maximum value: <code>3600</code> seconds.
    - `ManifestName` string, required — The name of the manifest for the channel that will appear in the channel output's playback URL.
    - `PlaybackUrl` string, required — The URL used for playback by content players.
    - `SourceGroup` string, required — A string used to associate a package configuration source group with a channel output.
  - `PlaybackMode` string — The playback mode to assign to the channel.
  - `Tags` object — The tags to assign to the channel. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see <a href="https://docs.aws.amazon.com/mediatailor/latest/ug/tagging.html">Tagging AWS Elemental MediaTailor Resources</a>.
  - `Tier` string — The tier of the channel.

---

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