Sign in

v1

latestOpenAPI 3.0.32026-07-148993228.8 KB
Playlists
Library

Create Playlist

Create a playlist for a Spotify user. (The playlist will be empty until you add tracks.)

post/users/{user_id}/playlists

Path parameters

user_idstring required

The user's Spotify user ID.

Example:smedjan

Request body

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.

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. If true the playlist will be public, if false it will be private. To be able to create private playlists, the user must have granted the playlist-modify-private scope

Example request

{
  "description": "New playlist description",
  "name": "New Playlist",
  "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: 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.