Create new playlist

POST https://api-v2.pandavideo.com/playlist

Creates a new video playlist for the authenticated user

POST /playlist

Detailed Description

Creates a new video playlist for the authenticated user. Use this when starting a new curated list of videos with configurable access rules and optional external button metadata.

HTTP Method & Path

POST /playlist

Authentication Requirements

• Security Scheme: PandaAuth (apiKey)
• Header: Authorization: <your_api_token> (no Bearer prefix)

Parameters

Name	Type	Required	Description
Authorization	string (header)	Yes	Panda API token (without Bearer prefix)

Request Body

Schema: CreatePlaylistRequest

Name	Type	Required	Description
name	string	Yes	Playlist name. minLength=1, maxLength=255.
description	string	No	Optional description. maxLength=1000.
access_type	string	Yes	One of public, private, anyone_with_password.
password	string	Conditionally	Required if access_type=anyone_with_password. minLength=6.
hide_views	boolean	No	Hide total views publicly. Default false.
creator_name	string	Yes	Display name of the playlist creator. minLength=1, maxLength=255.
external_button	object (ExternalButton)	No	Optional external call-to-action button.
image_id	string (uuid)	No	Optional cover image identifier.

Schema: ExternalButton

Name	Type	Required	Description
size	string	Yes	One of small, medium, large.
text	string	Yes	Button label. minLength=1, maxLength=50.
url	string (uri)	Yes	Destination URL.

Example Request Body

JSON

{
  "name": "My Playlist",
  "description": "A collection of tutorial videos",
  "access_type": "public",
  "hide_views": false,
  "creator_name": "John Doe",
  "external_button": {
    "size": "medium",
    "text": "Visit Website",
    "url": "https://example.com"
  },
  "image_id": "a6d1f7c8-1c2b-4d5e-9a10-1b2c3d4e5f60"
}

Notes

• If access_type is changed to password-protected later, ensure you provide a password that meets the minimum length.