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

# Create an independent livestream

`POST /livestreams`

## Request

- Base URL: `https://api.dyte.io/v2`
- URL: `https://api.dyte.io/v2/livestreams`
- Auth: HTTP basic

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.

## Changes

- **2025-04-04** (v2) `cb67ff854c71`: 1 info
  - the endpoint scheme security `Authorization` was added to the API
- **2025-04-03** (v2) `68b9e665bfcc`: 1 info
  - the endpoint scheme security `Authorization` was removed from the API
- **2024-11-20** (v2) `d8c5d90e84ac`: 1 info
  - the endpoint scheme security `Authorization` was added to the API
- **2023-07-18** (v2) `709c46a28a8b`: 4 warning, 2 info
  - removed the optional property `data/ingest_seconds` from the response with the `201` status
  - removed the optional property `data/viewer_seconds` from the response with the `201` status
  - added the new `IDLE` enum value to the `data/status` response property for the response status `201`
  - added the new `INVOKED` enum value to the `data/status` response property for the response status `201`
  - …2 more
- **2023-04-05** (v2) `a90bc09f2d8f`: 4 warning
  - deleted the `header` request parameter `Authorization`
  - added the new `ERRORED` enum value to the `data/status` response property for the response status `201`
  - added the new `LIVE` enum value to the `data/status` response property for the response status `201`
  - added the new `OFFLINE` enum value to the `data/status` response property for the response status `201`

[Operation history](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/changes/livestreams/post.md)

---

[API](https://skmtc.dev/dyte-io/apis/dyte-rest-apis.md) - [All operations](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/revisions/f62d3edd92ae?raw)