post
https://developer.dacast.com/v2/playlists
Create a new playlist.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Create a new playlist. After create, the playlist has no items yet (content.list is null). Add VOD or channel items with Set Playlist Content.
There is no public list endpoint for domain restriction, geo restriction, or theme resources. If you need values forreferers_id,countries_id, ortheme_id, contact support or use a theme id returned by create/lookup.
Request body
Send JSON with Content-Type: application/json.
| Field | Type | Description |
|---|---|---|
title | string | Required. Playlist title. |
description | string | Playlist description. |
online | boolean | Whether the playlist is enabled for playback. Default depends on the API; send explicitly if you need a specific state. |
password | string | Optional password to protect the playlist. |
google_analytics | string | Optional Google Analytics tracking code. When tracking is off, responses often show "false" as a string. |
referers_id | string | Optional domain restriction set id. |
countries_id | string | Optional geo restriction set id. |
theme_id | string | Optional theme id. If omitted, the API may assign a default theme. |
Response
| Code | Meaning |
|---|---|
| 200 | Playlist created. id is a UUID string. |
A follow-upGET /v2/playlists/{id}may need a short poll before the playlist is consistently available for update or content changes.