---
title: "Create broadcast"
method: POST
path: "/streaming/broadcasts"
tags: ["Broadcasts"]
---

# Create broadcast

`POST /streaming/broadcasts`

Broadcast entity is for setting up HTML video player, which serves to combine:
- many live streams,
- advertising,
- and design in one config.

If you use other players or you get streams by direct .m3u8/.mpd links, then you will not need this entity.

  


Scheme of "broadcast" entity using:
![Scheme of "broadcast" using](https://demo-files.gvideo.io/apidocs/broadcasts.png)

## Request body

- object
  - `broadcast` CreateBroadcast
    - `name` string, required — Broadcast name
    - `status` string — Broadcast statuses: **Pending** — default “Broadcast isn’t started yet” or custom message (see `pending_message` parameter) is shown, users don't see the live stream **Live** — broadcast is live, and viewers can see it **Paused** — “Broadcast is paused” message is shown, users don't see the live stream **Finished** — “Broadcast is finished” message is shown, users don't see the live stream The users' browsers start displaying the message/stream immediately after you change the broadcast status
    - `share_url` string — Custom URL or iframe displayed in the link field when a user clicks on a sharing button in player. If empty, the link field and social network sharing is disabled
    - `custom_iframe_url` string — Custom URL of iframe for video player to be shared via sharing button in player. Auto generated iframe URL is provided by default
    - `show_dvr_after_finish` boolean — Regulates if a DVR record is shown once a broadcast is finished. Has two possible values: - **true** — record is shown - **false** — record isn't shown Default is false
    - `pending_message` string — A custom message that is shown if broadcast status is set to pending. If empty, a default message is shown
    - `ad_id` integer — ID of ad to be displayed in a live stream. If empty the default ad is show. If there is no default ad, no ad is shown
    - `player_id` integer — ID of player to be used with a broadcast. If empty the default player is used
    - `stream_ids` integer[] — IDs of streams used in a broadcast
    - `poster` string — Uploaded poster file

## Response `200`

Successful

## Other responses

- `422` — Possible error messages: **{ "errors": { "name": [ "can't be blank" ] } }** *Name* is a required parameter, so it must be specified **{ "errors": { "status": [ "can't be blank" ] } }** *Status* is a required parameter, so it must be specified

---

[API](https://skmtc.net/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.net/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)