---
title: "Create an independent livestream"
method: POST
path: "/livestreams"
tags: ["Live streams"]
---

# Create an independent livestream

`POST /livestreams`

Creates a livestream for the given organization ID and returns ingest server, stream key, and playback URL. You can pass custom input to the ingest server and stream key, and freely distribute the content using the playback URL on any player that supports HLS/LHLS.

## Request body

- object
  - `name` string, nullable — Name of the livestream

## Response `201`

Successful response

- object
  - `success` boolean
  - `data` object
    - `status` 'LIVE' | 'IDLE' | 'ERRORED' | 'INVOKED'
    - `name` string
    - `meeting_id` string, nullable
    - `ingest_server` string — The server URL to which the RTMP encoder should send the video and audio data.
    - `id` string — The livestream ID.
    - `stream_key` string — Unique key for accessing each livestream.
    - `playback_url` string — The web address that viewers can use to watch the livestream.
    - `disabled` boolean — Specifies if the livestream was disabled.

---

[API](https://skmtc.net/dyte-io/apis/dyte-rest-apis.md) · [All operations](https://skmtc.net/dyte-io/apis/dyte-rest-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dyte-io/dyte-rest-apis/revisions/f62d3edd92ae/schema)