Create Playlist
Create a playlist for a Spotify user. (The playlist will be empty until you add tracks.)
Request
- user_idstringRequired
The user's Spotify user ID.
Example value:"smedjan"
- namestringRequired
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
. Iftrue
the playlist will be public, iffalse
it will be private. To be able to create private playlists, the user must have granted theplaylist-modify-private
scope - collaborativeboolean
Defaults to
false
. Iftrue
the playlist will be collaborative. Note: to create a collaborative playlist you must also setpublic
tofalse
. To create collaborative playlists you must have grantedplaylist-modify-private
andplaylist-modify-public
scopes. - descriptionstring
value for playlist description as displayed in Spotify Clients and in the Web API.
Response
A playlist
- collaborativeboolean
true
if the owner allows other users to modify the playlist. - descriptionstringNullable
The playlist description. Only returned for modified, verified playlists, otherwise
null
. Known external URLs for this playlist.
- spotifystring
The Spotify URL for the object.
Information about the followers of the playlist.
- hrefstringNullable
This will always be set to null, as the Web API does not support it at the moment.
- totalinteger
The total number of followers.
- hrefstring
A link to the Web API endpoint providing full details of the playlist.
- idstring
The Spotify ID for the playlist.
Images for the playlist. The array may be empty or contain up to three images. The images are returned by size in descending order. See Working with Playlists. Note: If returned, the source URL for the image (
url
) is temporary and will expire in less than a day.- urlstringRequired
The source URL of the image.
Example value:"https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
- heightintegerRequiredNullable
The image height in pixels.
Example value:300
- widthintegerRequiredNullable
The image width in pixels.
Example value:300
- namestring
The name of the playlist.
The user who owns the playlist
Known public external URLs for this user.
Information about the followers of this user.
- hrefstring
A link to the Web API endpoint for this user.
- idstring
The Spotify user ID for this user.
- typestring
The object type.
Allowed values:"user"
- uristring
The Spotify URI for this user.
- display_namestringNullable
The name displayed on the user's profile.
null
if not available.
- 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
The tracks of the playlist.
- hrefstringRequired
A link to the Web API endpoint returning the full result of the request
Example value:"https://api.spotify.com/v1/me/shows?offset=0&limit=20"
- limitintegerRequired
The maximum number of items in the response (as set in the query or by default).
Example value:20
- nextstringRequiredNullable
URL to the next page of items. (
null
if none)Example value:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- offsetintegerRequired
The offset of the items returned (as set in the query or by default)
Example value:0
- previousstringRequiredNullable
URL to the previous page of items. (
null
if none)Example value:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- totalintegerRequired
The total number of items available to return.
Example value:4
- Required
- typestring
The object type: "playlist"
- uristring
The Spotify URI for the playlist.