Playlists
Library

Create Playlist

Changed on

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

  • Base URL
    https://api.spotify.com/v1
  • URL
    https://api.spotify.com/v1/me/playlists
  • Auth
    OAuth 2
    Authorization code: https://accounts.spotify.com/authorize
    Token URL: https://accounts.spotify.com/api/token scopes: playlist-modify-public, playlist-modify-private

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.

Changes

  • 1602059e3988Revision changes
    • info

      response property items/allOf[PagingPlaylistTrackObject]/allOf[subschema #2]/items/items/item/oneOf[TrackObject]/external_ids reactivated

    • info

      response property items/allOf[PagingPlaylistTrackObject]/allOf[subschema #2]/items/items/track/oneOf[TrackObject]/external_ids reactivated

    • info

      response property tracks/allOf[PagingPlaylistTrackObject]/allOf[subschema #2]/items/items/item/oneOf[TrackObject]/external_ids reactivated

    • info

      response property tracks/allOf[PagingPlaylistTrackObject]/allOf[subschema #2]/items/items/track/oneOf[TrackObject]/external_ids reactivated

  • 8899d6fd66eeRevision changes
    • info

      endpoint added