create_playlist
Create a Plex playlist by providing a title and type. For regular playlists, include ratingKeys; for smart playlists, set smart=true and specify librarySectionId and filter.
Instructions
Create a new Plex playlist (requires PLEX_ENABLE_MUTATIVE_OPS=true). For regular playlists, ratingKeys is required — Plex does not support creating empty playlists. For smart playlists, set smart=true and provide librarySectionId (and optionally libtype / smartFilter).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | Yes | Playlist type (video, audio, photo) or media type (movie, show, episode, artist, album, track) | |
| smart | No | Create a smart playlist filtered from a library section (default: false) | |
| title | Yes | Playlist title | |
| libtype | No | Smart playlists only: content type to filter for. Defaults based on playlist type (audio->track, video->movie, photo->photo). | |
| ratingKeys | No | Rating keys to seed the playlist with. REQUIRED for non-smart playlists (>=1). All items are sent in a single POST, comma-joined in the playlist URI. Mutually exclusive with smart=true. | |
| smartFilter | No | Smart playlists only: raw Plex filter query string, e.g. 'genre=Drama&year>=2020&sort=titleSort:asc&limit=100'. Appended to the section URI. | |
| librarySectionId | No | Smart playlists only: library section ID to filter (e.g. '1'). REQUIRED when smart=true. |