Playlists

Add Items to Playlist

POST
/playlists/{playlist_id}/tracks

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

Authorization

oauth_2_0 playlist-modify-public, playlist-modify-private
AuthorizationBearer <token>

Spotify supports OAuth 2.0 for authenticating all API requests.

In: header

Scope: playlist-modify-public, playlist-modify-private

Path Parameters

playlist_id*Playlist ID

The Spotify ID of the playlist.

Query Parameters

position?Position (append by default)

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.

uris?Spotify Track URIs

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:512ojhOuo1ktJprKbVcKyQA 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.

Request Body

application/json

uris?array<string>

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}

[key: string]?any

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/playlists/3cEYpjA9oz9GiPac4AsH4n/tracks" \  -H "Content-Type: application/json" \  -d '{}'
{  "snapshot_id": "abc"}