---
title: "Create a live stream playback ID"
method: POST
path: "/video/v1/live-streams/{LIVE_STREAM_ID}/playback-ids"
tags: ["Live Streams"]
---

# Create a live stream playback ID

`POST /video/v1/live-streams/{LIVE_STREAM_ID}/playback-ids`

## Request

- Base URL: `https://api.mux.com`
- URL: `https://api.mux.com/video/v1/live-streams/{LIVE_STREAM_ID}/playback-ids`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Create a new playback ID for this live stream, through which a viewer can watch the streamed content of the live stream.

## Path parameters

- `LIVE_STREAM_ID` string, required

## Request body

- CreatePlaybackIDRequest
  - `policy` 'public' | 'signed' | 'drm': * `public` playback IDs are accessible by constructing an HLS URL like `https://stream.mux.com/${PLAYBACK_ID}` * `signed` playback IDs should be used with tokens `https://stream.mux.com/${PLAYBACK_ID}?token={TOKEN}`. See [Secure video playback](https://docs.mux.com/guides/secure-video-playback) for details about creating tokens. * `drm` playback IDs are protected with DRM technologies. [See DRM documentation for more details](https://docs.mux.com/guides/protect-videos-with-drm).
  - `drm_configuration_id` string: The DRM configuration used by this playback ID. Must only be set when `policy` is set to `drm`.

## Response `201`

Created

- CreatePlaybackIDResponse
  - `data` PlaybackID, required
    - `id` string, required: Unique identifier for the PlaybackID
    - `policy` 'public' | 'signed' | 'drm', required: * `public` playback IDs are accessible by constructing an HLS URL like `https://stream.mux.com/${PLAYBACK_ID}` * `signed` playback IDs should be used with tokens `https://stream.mux.com/${PLAYBACK_ID}?token={TOKEN}`. See [Secure video playback](https://docs.mux.com/guides/secure-video-playback) for details about creating tokens. * `drm` playback IDs are protected with DRM technologies. [See DRM documentation for more details](https://docs.mux.com/guides/protect-videos-with-drm).
    - `drm_configuration_id` string: The DRM configuration used by this playback ID. Must only be set when `policy` is set to `drm`.

## Changes

- **2025-08-05** `ba7ebfd893a1`: 1 info
  - the endpoint scheme security `authorizationToken` was added to the API
- **2025-07-02** `d4d7fca3b738`: 1 info
  - the endpoint scheme security `accessToken` was added to the API
- **2024-06-17** `b1c7a231d908`: 1 info
  - added the new optional request property `drm_configuration_id`
- **2024-06-17** `cc252d3a50f1`: 1 warning, 2 info
  - added the new `drm` enum value to the `data/policy` response property for the response status `201`
  - added the new `drm` enum value to the request property `policy`
  - added the optional property `data/drm_configuration_id` to the response with the `201` status
- **2024-06-06** `dcdbbcabe09e`: 1 breaking, 1 warning, 1 info
  - removed the enum value `drm` of the request property `policy`
  - removed the optional property `data/drm_configuration_id` from the response with the `201` status
  - removed the `drm` enum value from the `data/policy` response property for the response status `201`

[Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/video/v1/live-streams/:LIVE_STREAM_ID/playback-ids/post.md)

---

[API](https://skmtc.dev/muxinc/apis/mux-api.md) - [All operations](https://skmtc.dev/muxinc/apis/mux-api/llms.txt) - [OpenAPI document](https://skmtc.dev/muxinc/apis/mux-api/revisions/75b4251a1d96?raw)