---
title: "Create new playlist"
method: POST
path: "/playlists"
tags: ["Playlists"]
---

# Create new playlist

`POST /playlists`

Creates a new video playlist for the authenticated user

## Request body

- CreatePlaylistRequest
  - `name` string, required
  - `description` string
  - `access_type` 'public' | 'private' | 'anyone_with_password', required
  - `password` string — Required when access_type is anyone_with_password
  - `hide_views` boolean
  - `creator_name` string, required
  - `external_button` ExternalButton
    - `size` 'small' | 'medium' | 'large', required
    - `text` string, required
    - `url` string, uri, required
  - `image_id` string, uuid, nullable

## Response `201`

Playlist created successfully

- object
  - `data` PlaylistCreated
    - `id` string, uuid
    - `name` string
    - `user_id` string, uuid
  - `message` string

## Other responses

- `400` — Bad request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing authentication
- `500` — Internal server error

---

[API](https://skmtc.net/pandavideo/apis/api-v2.md) · [All operations](https://skmtc.net/pandavideo/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandavideo/api-v2/revisions/4fbd3c623ca9/schema)