Skip to content
Announcement:We are updating the criteria to be granted extended access to the Web API.
Please note that starting May 15, 2025 we’re introducing some changes to the way we provide Web API extended quota mode access. For more information, read here.
Web APIReferences / Playlists / Add Items to Playlist

Add Items to Playlist

Add one or more items to a user's playlist.

Authorization scopes

Request

  • playlist_id
    string
    Required

    The Spotify ID of the playlist.

    Example: 3cEYpjA9oz9GiPac4AsH4n
  • position
    integer

    The position to insert the items, a zero-based index. For example, to insert the items in the first position: position=0; to insert the items in the third position: position=2. If omitted, the items will be appended to the playlist. Items are added in the order they are listed in the query string or request body.

    Example: position=0
  • uris
    string

    A comma-separated list of Spotify URIs to add, can be track or episode URIs. For example:
    uris=spotify:track:4iV5W9uYEdYUVa79Axb7Rh, spotify:track:1301WleyT98MSxVHPZCA6M, spotify:episode:512ojhOuo1ktJprKbVcKyQ
    A maximum of 100 items can be added in one request.
    Note: it is likely that passing a large number of item URIs as a query parameter will exceed the maximum length of the request URI. When adding a large number of items, it is recommended to pass them in the request body, see below.

    Example: uris=spotify%3Atrack%3A4iV5W9uYEdYUVa79Axb7Rh,spotify%3Atrack%3A1301WleyT98MSxVHPZCA6M
supports free form additional properties
  • uris
    array of strings

    A JSON array of the Spotify URIs to add. For example: {"uris": ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh","spotify:track:1301WleyT98MSxVHPZCA6M", "spotify:episode:512ojhOuo1ktJprKbVcKyQ"]}
    A maximum of 100 items can be added in one request. Note: if the uris parameter is present in the query string, any URIs listed here in the body will be ignored.

  • position
    integer

    The position to insert the items, a zero-based index. For example, to insert the items in the first position: position=0 ; to insert the items in the third position: position=2. If omitted, the items will be appended to the playlist. Items are added in the order they appear in the uris array. For example: {"uris": ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh","spotify:track:1301WleyT98MSxVHPZCA6M"], "position": 3}

Response

A snapshot ID for the playlist

  • snapshot_id
    string
    Example: "abc"
endpointhttps://api.spotify.com/v1/playlists/{playlist_id}/tracksplaylist_idpositionuris

Request body


Response sample