Sign in

v1

latestOpenAPI 3.0.32026-07-139687282.9 KB
Playlists
Library

Create Playlist

Create a playlist for the current Spotify user. (The playlist will be empty until you add tracks.) Each user is generally limited to a maximum of 11000 playlists.

post/me/playlists

Request body

namestring required

The name for the new playlist, for example "Your Coolest Playlist". This name does not need to be unique; a user may have several playlists with the same name.

publicboolean

Defaults to true. The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private. To be able to create private playlists, the user must have granted the playlist-modify-private scope. For more about public/private status, see Working with Playlists

collaborativeboolean

Defaults to false. If true the playlist will be collaborative. Note: to create a collaborative playlist you must also set public to false. To create collaborative playlists you must have granted playlist-modify-private and playlist-modify-public scopes.

descriptionstring

value for playlist description as displayed in Spotify Clients and in the Web API.

Example request

{
  "name": "New Playlist",
  "description": "New playlist description",
  "public": false
}

Response

A playlist

collaborativeboolean

true if the owner allows other users to modify the playlist.

descriptionstring nullable

The playlist description. Only returned for modified, verified playlists, otherwise null.

hrefstring

A link to the Web API endpoint providing full details of the playlist.

idstring

The Spotify ID for the playlist.

namestring

The name of the playlist.

publicboolean

The playlist's public/private status (if it is added to the user's profile): true the playlist is public, false the playlist is private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

snapshot_idstring

The version identifier for the current playlist. Can be supplied in other requests to target a specific playlist version

typestring

The object type: "playlist"

uristring

The Spotify URI for the playlist.