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

# Create playlist

`POST /playlists`

## Request

- Base URL: `https://acornonaut.app/api/v1`
- URL: `https://acornonaut.app/api/v1/playlists`
- Auth: `BearerAuth` (a scheme the document does not define)

Create a new playlist from a YouTube URL and queue video processing.

## Request body

- CreatePlaylistRequest
  - `url` string, required: YouTube playlist or video URL
  - `title` string: Optional custom title
  - `autoGenerateCards` boolean: Queue card generation immediately

## Response `201`

Playlist created

## Other responses

- `400`: Invalid request
- `401`: Authentication required
- `403`: Insufficient permissions

---

[API](https://skmtc.dev/acornonaut/apis/acornonaut-api.md) · [All operations](https://skmtc.dev/acornonaut/apis/acornonaut-api/llms.txt) · [OpenAPI document](https://skmtc.dev/acornonaut/apis/acornonaut-api/revisions/b0825bb7568a?raw)