Skip to content
Web APIReferences / Playlists / Create Playlist

Create Playlist

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

Authorization scopes

Request

supports free form additional properties
  • name
    string
    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.

  • public
    boolean

    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

  • collaborative
    boolean

    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.

  • description
    string

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

Response

A playlist

  • collaborative
    boolean

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

  • description
    string
    Nullable

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

  • Known external URLs for this playlist.

  • Information about the followers of the playlist.

    • href
      string
      Nullable

      This will always be set to null, as the Web API does not support it at the moment.

    • total
      integer

      The total number of followers.

  • href
    string

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

  • id
    string

    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.

    • url
      string
      Required

      The source URL of the image.

      Example value: "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
    • height
      integer
      Required
      Nullable

      The image height in pixels.

      Example value: 300
    • width
      integer
      Required
      Nullable

      The image width in pixels.

      Example value: 300
  • name
    string

    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.

    • href
      string

      A link to the Web API endpoint for this user.

    • id
      string

      The Spotify user ID for this user.

    • type
      string

      The object type.

      Allowed values: "user"
    • uri
      string

      The Spotify URI for this user.

    • display_name
      string
      Nullable

      The name displayed on the user's profile. null if not available.

  • public
    boolean

    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_id
    string

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

  • The tracks of the playlist.

    • href
      string
      Required

      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"
    • limit
      integer
      Required

      The maximum number of items in the response (as set in the query or by default).

      Example value: 20
    • next
      string
      Required
      Nullable

      URL to the next page of items. ( null if none)

      Example value: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
    • offset
      integer
      Required

      The offset of the items returned (as set in the query or by default)

      Example value: 0
    • previous
      string
      Required
      Nullable

      URL to the previous page of items. ( null if none)

      Example value: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
    • total
      integer
      Required

      The total number of items available to return.

      Example value: 4
    • Required
  • type
    string

    The object type: "playlist"

  • uri
    string

    The Spotify URI for the playlist.