[Yandex Cloud documentation](../../../index.md) > [Yandex Cloud Video](../../index.md) > [Step-by-step guides](../index.md) > Channels > Creating a channel

# Creating a channel

{% list tabs group=instructions %}

- Cloud Video interface {#console}

  1. Open the Cloud Video [home page](https://video.yandex.cloud/).
  1. Click ![plus-sign](../../../_assets/console-icons/plus.svg) **Create a channel**.
  1. On the channel creation page, enter:
      * **Name**.
      * **Description** (optional setting).
  1. Click **Create**.
  
  Once the channel is created, you will find yourself inside it on the ![image](../../../_assets/console-icons/circle-play.svg) **Video** tab.
  
  * To learn more about channels, see [Channels](../../concepts/index.md#channels).
  * To learn more about configuring ads, see [Configuring ads](settings.md#ad-settings).

- REST API {#api}

  Run this command:

  ```bash
  curl \
    --request POST \
    --url 'https://video.api.cloud.yandex.net/video/v1/channels' \
    --header 'Authorization: Bearer <IAM_token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "organization_id": "<organization_ID>",
      "title": "<channel_name>"
    }'
  ```

  Where:
  * `<IAM_token>`: [IAM token](../../../iam/concepts/authorization/iam-token.md) required for [authenticating](../../api-ref/authentication.md) with the Cloud Video API.
  * `<organization_ID>`: [ID](../../../organization/operations/organization-get-id.md) of the organization to create a Cloud Video channel in.
  * `<channel_name>`: Name of the channel you are creating in Cloud Video.

  Result:
  
  ```text
  {
   "done": true,
   "metadata": {
    "@type": "type.googleapis.com/yandex.cloud.video.v1.CreateChannelMetadata",
    "channelId": "vplcdyphvqik********"
   },
   "response": {
    "@type": "type.googleapis.com/yandex.cloud.video.v1.Channel",
    "id": "vplcdyphvqik********",
    "organizationId": "bpfaidqca8vd********",
    "title": "my-very-first-channel",
    "createdAt": "2024-09-16T19:01:10.591128Z",
    "updatedAt": "2024-09-16T19:01:10.591128Z"
   },
   "id": "vplp4vofhojp********",
   "description": "Channel create",
   "createdAt": "2024-09-16T19:01:10.596734Z",
   "createdBy": "ajeol2afu1js********",
   "modifiedAt": "2024-09-16T19:01:10.596734Z"
  }
  ```

- gRPC API {#grpc-api}

  Run this command:

  ```bash
  grpcurl \
    -rpc-header "Authorization: Bearer <IAM_token>" \
    -d '{
      "organization_id": "<organization_ID>",
      "title": "<channel_name>"
    }' \
    video.api.cloud.yandex.net:443 yandex.cloud.video.v1.ChannelService/Create
  ```

  Where:
  * `<IAM_token>`: [IAM token](../../../iam/concepts/authorization/iam-token.md) required for [authenticating](../../api-ref/authentication.md) with the Cloud Video API.
  * `<organization_ID>`: [ID](../../../organization/operations/organization-get-id.md) of the organization to create a Cloud Video channel in.
  * `<channel_name>`: Name of the channel you are creating in Cloud Video.

  Result:
  
  ```text
  {
    "id": "vplpvkqo2uyv********",
    "description": "Channel create",
    "createdAt": "2024-09-16T10:36:56.973051Z",
    "createdBy": "ajeol2afu1js********",
    "modifiedAt": "2024-09-16T10:36:56.973051Z",
    "done": true,
    "metadata": {
      "@type": "type.googleapis.com/yandex.cloud.video.v1.CreateChannelMetadata",
      "channelId": "vplcqy2qxkjy********"
    },
    "response": {
      "@type": "type.googleapis.com/yandex.cloud.video.v1.Channel",
      "createdAt": "2024-09-16T10:36:56.968240Z",
      "id": "vplcqy2qxkjy********",
      "organizationId": "bpfaidqca8vd********",
      "title": "my-very-first-channel",
      "updatedAt": "2024-09-16T10:36:56.968240Z"
    }
  }
  ```

{% endlist %}