Playlists

Create a new playlist.

Changed on Sep 17, 2026

post/playlists

Request

Base URL
https://api.reveldigital.com
Auth
- OAuth 2
  Authorization codehttps://id.reveldigital.com/connect/authorize
  Token URLhttps://id.reveldigital.com/connect/token
  Scopeswebapi
- or API key in header X-RevelDigital-ApiKey
- or API key in query parameter api_key
TypeScript
https://skmtc.dev/reveldigital/apis/revel-digital-rest-api/docs/playlists/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

idstring nullable

The playlist id

namestring nullable

The playlist name

group_namestring nullable

The group name

group_idstring nullable

The group id

tagsstring nullable

The tags associated with this playlist

type'Multimedia' | 'Slideshow' | 'Template' | 'Marquee'

durationinteger nullable

User-defined fixed duration for this playlist in seconds. Used in conjunction with loop policy to control how sources are looped or truncated to fit within this fixed duration. This is different from CalculatedDuration which represents the sum of all source durations.

calculated_durationinteger nullable

The total calculated duration of the playlist in seconds, based on the sum of all source intervals. This is a read-only property computed from individual source durations and cannot be updated via PUT/POST.

is_random_startboolean nullable

Randomize the order of the playlist

created_onstring date-time nullable

The date the playlist was created

created_by_idstring nullable

The user id that created the playlist

modified_onstring date-time nullable

The date the playlist was last modified

modified_by_idstring nullable

The user id that last modified the playlist

Response

Returns the newly-created playlist