---
title: "Creates a new playlist."
method: POST
path: "/Playlists"
tags: ["Playlists"]
---

# Creates a new playlist.

`POST /Playlists`

For backwards compatibility parameters can be sent via Query or Body, with Query having higher precedence.

## Query parameters

- `name` string, nullable — The playlist name.
- `ids` string[], nullable — The item ids.
- `userId` string, uuid, nullable — The user id.
- `mediaType` string, nullable — The media type.

## Request body

- CreatePlaylistDto — Create new playlist dto.
  - `Name` string, nullable — Gets or sets the name of the new playlist.
  - `Ids` string[], nullable — Gets or sets item ids to add to the playlist.
  - `UserId` string, uuid, nullable — Gets or sets the user id.
  - `MediaType` string, nullable — Gets or sets the media type.

## Response `200`

Success

- PlaylistCreationResult
  - `Id` string, nullable

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

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