Skip to main content
POST
Create a new playlist

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Body

application/json

Request body for creating a new playlist

name
string
required

Playlist name (required)

Required string length: 1 - 255
Example:

"Product Tutorials"

description
string

Playlist description

Maximum string length: 5000
Example:

"A collection of tutorial videos"

emoji
string

Unicode emoji character for the playlist

Maximum string length: 10
Example:

"🎬"

Access level (default: public)

Available options:
public,
private,
password,
embedonly
Example:

"public"

password
string

Password for viewing. Required when linkScope is 'password', ignored otherwise.

Required string length: 1 - 255
Example:

"secretpassword"

searchEngineIndexingEnabled
boolean

Allow search engine indexing (default: false)

Example:

false

visibility
enum<string>

Share with org or keep personal (default: personal)

Available options:
org,
personal
Example:

"org"

Response

OK

playlist
object
required

Detailed information about a playlist