--- title: "Create a channel" method: POST path: "/1/videos" tags: ["Channel"] --- # Create a channel `POST /1/videos` This endpoint allows you to create a channel. ## Query parameters - `account_id` integer, required — Account identifier - `ttl` integer — Specify the name of the channel ## Request body - object - `name` string, required — Specify the name of the channel ## Response `201` Created - object - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request - `data` A57c9d69Channel - `id` string, required — Unique identifier of the resource `Channel` - `unique_id` integer, required — Unique identifier of the resource `Channel` - `channel_id` integer, required — Unique identifier of the `channel` that is related to the resource `Channel` - `name` string, required — Name of the resource `Channel` - `created_at` integer, required — Timestamp `Channel` has been created - `updated_at` integer, required — Timestamp `Channel` has been updated - `deleted_at` integer, required — Timestamp `Channel` has been deleted - `deleted` boolean, required — Boolean `Channel` has been deleted - `type` 'abr' | 'mono', required - `source_type` 'camip' | 'encoder' | 'maniak' | 'mobile' | 'webcam', required - `remember_to_config` boolean, required - `free` boolean, required - `blocked` boolean, required - `maintained` boolean, required - `blocked_at` integer, required - `maintained_at` integer, required - `is_pulled` boolean, required - `service_id` integer, required — Unique identifier of the `service` that is related to the resource `Channel` - `customer_name` string, required — Customer name of the resource `Channel` - `parent_id` integer, required - `tags` string - `rights` string - `live` A57c9d69Liveressource - `server_name` string, required - `application_instance` string, required - `bytes_in` integer, required - `bytes_out` integer, required - `bytes_in_rate` integer, required - `bytes_out_rate` integer, required - `total_connections` integer, required - `real_type` string, required - `status` unknown[] — Status of the resource `Channel` - unknown - `consumption` A57c9d69Fieldresource - `value` number, required — the current monthly consumption (Byte) - `from` integer, required — Timestamp `Field resource` from - `to` integer, required — Timestamp `Field resource` to - `recording_status` string - `options_orders` string - `options` unknown[] - unknown - `default_options` unknown[] - unknown - `streams` A57c9d69Stream[] - `stream_id` string, required — Unique identifier of the `stream` that is related to the resource `stream` - `original_stream_id` string, required - `rendered` boolean, required - `transcoding_option_id` integer, required — Unique identifier of the `Option transcoding` that is related to the resource `stream` - `url` string, required - `audio_bitrate` integer, required - `video_bitrate` integer, required - `language` string, required - `created_at` integer, required — Timestamp `stream` has been created - `interrupted_at` integer, required — Timestamp `stream` has been interrupted - `restrictions_id` integer, required — Unique identifier of the `restriction` that is related to the resource `stream` - `published` boolean, required - `resolution` integer, required - `recording_config_id` integer, required — Unique identifier of the `recording config` that is related to the resource `stream` - `username` string, required - `pass` string, required - `interrupted` boolean, required - `audio_codec` string, required - `frame_rate` string, required - `keyframe_rate` integer, required - `instant_connection` integer, required - `channel` A57c9d69Channel, required — recursive - `restriction` A57c9d69ViewersRestrictions - `restrictions_id` integer, required — Unique identifier of the `restriction` that is related to the resource `ViewersRestrictions` - `access_country` string, required - `allow_domain` string, required - `exception_ip` string, required - `forbidden_ip` string, required - `shared_key` string, required - `authorize_country` boolean, required - `player_token` string, required - `machines` A57c9d69Machine[] - `name` string, required — Name of the resource `Machine` - `ip` string, required - `url` string, required - `type` 'edge' | 'load-balancer' | 'master' | 'recorder' | 'time-shifter' | 'transcoder', required — Type of server - `pool_id` integer, required - `url_domain` string, required - `players` A57c9d69Player[] - `player_id` integer, required — Unique identifier of the `player` that is related to the resource `Player` - `name` string, required — Name of the ressource `Player` visible by final customer - `title` string, required — Name of the video stream - `description` string, required — Description of the stream - `buffer` string, required — Buffer memory enables the reduction of video interruptions if yours viewers connections become unstable by preloading - `auto_start` boolean, required — Start the video automatically (does not function on Android and iOS) - `allow_full_screen` boolean, required — Authorise full-screen mode - `is360` boolean, required — This option is required to display your 360 video streaming - `show_controls` boolean, required — Display the playback bar - `auto_hide_controls` boolean, required — Hide the playback bar after a few seconds - `time_before_hide_cb` integer, required - `show_viewers` boolean, required — Display the number of viewers - `show_viewers_after` integer, required — Display from the following number after {number} viewers - `ratio` string, required — Ratio of the player - `width` integer, required — The width used for render the `Player` (px) - `height` integer, required — The height used for render the `Player` (px) - `show_logo` boolean, required — Is the logo Infomaniak enabled? - `logo_img` string, required — The logo url of the `Player` - `logo_anchor` 'bottom left' | 'bottom right' | 'top left' | 'top right', required — is the position of logo - `logo_percentage` integer, required — The logo size in `Player` - `logo_margin_top` integer, required — The margin top log in `Player` - `logo_margin_left` integer, required — The margin left log in `Player` - `control_color` string, required — The background color used in the `Player` - `controlbar_color` string, required — The button color used in the `Player` - `control_active_color` string, required — The secondary color color used in the `Player` - `extract_preload_img` boolean, required - `use_preload_img` boolean, required — This image is displayed before the video is played. - `preload_img` string, required - `use_geo_ip_img` boolean, required - `geo_ip_img` string, required - `use_interrupt_img` boolean, required - `interrupt_img` string, required — This image is displayed if the viewer is not authorised to view the broadcast (IP, domain, unique hash code, etc.) - `use_restrict_img` boolean, required — This image is displayed if the viewer is located in an unauthorised geographic - `restrict_img` string, required — This image is displayed if the viewer is not authorised to view the broadcast (IP, domain, unique hash code, etc.) - `countdown` boolean, required — Is the countdown enabled? - `countdown_txt` string, required — Description of the countdown of the `Player` visible by final customer - `countdown_days` string, required — countdown days - `countdown_hours` string, required — hours days - `countdown_minutes` string, required — countdown minutes - `countdown_seconds` string, required — countdown seconde - `enable_embed_code` boolean, required — Authorise other users to intergrate your live event on their sites - `enable_facebook` boolean, required — Is the facebook embed link visible? - `facebook_back_link` string, required — The Twitter backlink used to facebook embed - `facebook_player_embed` boolean, required - `enable_twitter` boolean, required — Is the Twitter embed link visible? - `twitter_via` string, required - `twitter_back_link` string, required — The Twitter backlink used to twitter embed - `twitter_related` string, required — The Twitter hashtag used to Twitter embed - `created_at` integer, required — Timestamp `Player` has been created - `updated_at` integer, required — Timestamp `Player` has been updated - `ads_enabled` boolean, required — Is the ads enabled? - `show_controls_during_ads` boolean, required — Display the playback bar during the ads - `sound_enabled` boolean, required — Is the sound enabled? - `sound_percentage` integer, required — The volume used in the `Player` - `show_viewers_only_after` boolean, required - `chromecast` boolean, required — you need to use a player that supports https in order for chromecast to work correctly - `stereo_projection360` string, required - `ads_url` string, required — The ads url - `interrupted` boolean — There is an event currently interrupting the live; - `channel` A57c9d69Channel — recursive - `integrations` A57c9d69Integrationsressource[] — List all the raw integrations supported for the given channel. - `type` string, required - `url` string, required - `constant_url` boolean, required - `stream_id` string, required — Unique identifier of the `stream` that is related to the resource `Integrations ressource` - `dvr_available` boolean, required - `dvr_enabled` boolean, required - `countdown_stops_at` string - `thumbnail_url` string - `restrictions` string - `ads` string - `order` string - `account` string - `pool` string - `transcoders` A57c9d69Machine[] - `name` string, required — Name of the resource `Machine` - `ip` string, required - `url` string, required - `type` 'edge' | 'load-balancer' | 'master' | 'recorder' | 'time-shifter' | 'transcoder', required — Type of server - `pool_id` integer, required - `url_domain` string, required --- [API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)