Skip to content

Scopes

Scopes provide Spotify users using third-party apps the confidence that only the information they choose to share will be shared, and nothing more.

Pre-requisites

Scopes are needed when implementing some of the authorization grant types. Make sure you have read the Authorization guide to understand the basics.

List of Scopes

ugc-image-upload

DescriptionWrite access to user-provided images.
Visible to usersUpload images to Spotify on your behalf.

Endpoints that require the ugc-image-upload scope

user-read-playback-state

DescriptionRead access to a user’s player state.
Visible to usersRead your currently playing content and Spotify Connect devices information.

Endpoints that require the user-read-playback-state scope

user-modify-playback-state

DescriptionWrite access to a user’s playback state
Visible to usersControl playback on your Spotify clients and Spotify Connect devices.

Endpoints that require the user-modify-playback-state scope

user-read-currently-playing

DescriptionRead access to a user’s currently playing content.
Visible to usersRead your currently playing content.

Endpoints that require the user-read-currently-playing scope

app-remote-control

DescriptionRemote control playback of Spotify. This scope is currently available to Spotify iOS and Android SDKs.
Visible to usersCommunicate with the Spotify app on your device.

Endpoints that require the app-remote-control scope

streaming

DescriptionControl playback of a Spotify track. This scope is currently available to the Web Playback SDK. The user must have a Spotify Premium account.
Visible to usersPlay content and control playback on your other devices.

Endpoints that require the streaming scope

playlist-read-private

DescriptionRead access to user's private playlists.
Visible to usersAccess your private playlists.

Endpoints that require the playlist-read-private scope

playlist-read-collaborative

DescriptionInclude collaborative playlists when requesting a user's playlists.
Visible to usersAccess your collaborative playlists.

Endpoints that require the playlist-read-collaborative scope

playlist-modify-private

DescriptionWrite access to a user's private playlists.
Visible to usersManage your private playlists.

Endpoints that require the playlist-modify-private scope

playlist-modify-public

DescriptionWrite access to a user's public playlists.
Visible to usersManage your public playlists.

Endpoints that require the playlist-modify-public scope

user-follow-modify

DescriptionWrite/delete access to the list of artists and other users that the user follows.
Visible to usersManage who you are following.

Endpoints that require the user-follow-modify scope

user-follow-read

DescriptionRead access to the list of artists and other users that the user follows.
Visible to usersAccess your followers and who you are following.

Endpoints that require the user-follow-read scope

user-read-playback-position

DescriptionRead access to a user’s playback position in a content.
Visible to usersRead your position in content you have played.

Endpoints that require the user-read-playback-position scope

user-top-read

DescriptionRead access to a user's top artists and tracks.
Visible to usersRead your top artists and content.

Endpoints that require the user-top-read scope

user-read-recently-played

DescriptionRead access to a user’s recently played tracks.
Visible to usersAccess your recently played items.

Endpoints that require the user-read-recently-played scope

user-library-modify

DescriptionWrite/delete access to a user's "Your Music" library.
Visible to usersManage your saved content.

Endpoints that require the user-library-modify scope

user-library-read

DescriptionRead access to a user's library.
Visible to usersAccess your saved content.

Endpoints that require the user-library-read scope

user-read-email

DescriptionRead access to user’s email address.
Visible to usersGet your real email address.

Endpoints that require the user-read-email scope

user-read-private

DescriptionRead access to user’s subscription details (type of user account).
Visible to usersAccess your subscription details.

Endpoints that require the user-read-private scope

DescriptionLink a partner user account to a Spotify user account

Endpoints that require the user-soa-link scope

DescriptionUnlink a partner user account from a Spotify account

Endpoints that require the user-soa-unlink scope

soa-manage-entitlements

DescriptionModify entitlements for linked users

Endpoints that require the soa-manage-entitlements scope

soa-manage-partner

DescriptionUpdate partner information

Endpoints that require the soa-manage-partner scope

soa-create-partner

DescriptionCreate new partners, platform partners only

Endpoints that require the soa-create-partner scope