Sign in

v1

latestOpenAPI 3.0.32026-07-148993228.8 KB
Playlists
Tracks

Add Items to Playlist

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

post/playlists/{playlist_id}/tracks

Path parameters

playlist_idstring required

The Spotify ID of the playlist.

Example:3cEYpjA9oz9GiPac4AsH4n

Query parameters

positioninteger

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.

urisstring

A comma-separated list of Spotify URIs to add, can be track or episode URIs. For example:<br/>uris=spotify:track:4iV5W9uYEdYUVa79Axb7Rh, spotify:track:1301WleyT98MSxVHPZCA6M, spotify:episode:512ojhOuo1ktJprKbVcKyQ<br/>A maximum of 100 items can be added in one request. <br/> 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:spotify:track:4iV5W9uYEdYUVa79Axb7Rh,spotify:track:1301WleyT98MSxVHPZCA6M

Request body

positioninteger

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}

urisstring[]

A JSON array of the Spotify URIs to add. For example: {"uris": ["spotify:track:4iV5W9uYEdYUVa79Axb7Rh","spotify:track:1301WleyT98MSxVHPZCA6M", "spotify:episode:512ojhOuo1ktJprKbVcKyQ"]}<br/>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.

Response

A snapshot ID for the playlist

snapshot_idstring

Example response

{
  "snapshot_id": "abc"
}