Endpoint

PUT https://api.spotify.com/v1/users/{owner_id}/playlists/{playlist_id}/followers

Request Parameters

Path Parameters

Path Parameter Value
owner_id The Spotify user ID of the person who owns the playlist.
playlist_id The Spotify ID of the playlist. Any playlist can be followed, regardless of its public/private status, as long as you know its playlist ID.

Header Fields

Header Field Value
Authorization Required. A valid access token from the Spotify Accounts service: see the Web API Authorization Guide for details. The access token must have been issued on behalf of the current user.
Following a playlist publicly requires authorization of the playlist-modify-public scope; following it privately requires the playlist-modify-private scope. See Using Scopes.
Note that the scopes you provide determine only whether the current user can themselves follow the playlist publicly or privately (i.e. show others what they are following), not whether the playlist itself is public or private.
Content-Type Required. The content type of the request body: application/json

Body Parameters

Request Body Data Value Type Value
public Boolean Optional. Defaults to true. If true the playlist will be included in user’s public playlists, if false it will remain private. To be able to follow playlists privately, the user must have granted the playlist-modify-private scope.

Response Format

On success, the HTTP status code in the response header is 200 OK and the response body is empty. On error, the header status code is an error code and the response body contains an error object.

Example (follow a playlist publicly)

We want to add the current user as a follower of playlist spotify:user:jmperezperez:playlist:2v3iNvBX8Ay1Gt2uXtUKUT:

curl -X PUT "https://api.spotify.com/v1/users/jmperezperez/playlists/2v3iNvBX8Ay1Gt2uXtUKUT/followers" -H "Authorization: Bearer {your access token}" -H "Content-Type: application/json" --data "{\"public\": true}"
HTTP/1.1 200 OK

Try it

Example (follow a playlist privately)

We want to add the current user as a follower of playlist spotify:user:jmperezperez:playlist:2v3iNvBX8Ay1Gt2uXtUKUT, but don’t want to include this playlist in the current user’s public playlists:

curl -X PUT "https://api.spotify.com/v1/users/jmperezperez/playlists/2v3iNvBX8Ay1Gt2uXtUKUT/followers" -H "Authorization: Bearer {your access token}" -H "Content-Type: application/json" --data "{\"public\": false}"
HTTP/1.1 200 OK

Try it