Create Playlist
Create a playlist for a Spotify user. (The playlist will be empty until you add tracks.) Each user is generally limited to a maximum of 11000 playlists.
Request
- user_idstringRequired
The user's Spotify user ID.
Example: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
. 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 theplaylist-modify-private
scope. For more about public/private status, see Working with Playlists - 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:"https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
- heightintegerRequiredNullable
The image height in pixels.
Example:300
- widthintegerRequiredNullable
The image width in pixels.
Example:300
- namestring
The name of the playlist.
The user who owns the playlist
Known public external URLs for this user.
- spotifystring
The Spotify URL for the object.
Information about the followers of this user.
- 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 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 (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
The tracks of the playlist.
- hrefstringRequired
A link to the Web API endpoint returning the full result of the request
Example:"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:20
- nextstringRequiredNullable
URL to the next page of items. (
null
if none)Example:"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:0
- previousstringRequiredNullable
URL to the previous page of items. (
null
if none)Example:"https://api.spotify.com/v1/me/shows?offset=1&limit=1"
- totalintegerRequired
The total number of items available to return.
Example:4
- Required
- typestring
The object type: "playlist"
- uristring
The Spotify URI for the playlist.