Authorization Scopes
In order to use the Spotify Platform, you need to familiarise yourself with 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.
Overview
- Images
- Spotify Connect
- Users
- Follow
- Library
- Playback
- Listening History
- Playlists
Scopes
ugc-image-upload
| Description | Write access to user-provided images. |
| Visible to users | Upload images to Spotify on your behalf. |
|
Endpoints that require the |
|
user-read-playback-state
| Description | Read access to a user’s player state. |
| Visible to users | Read your currently playing content and Spotify Connect devices information. |
|
Endpoints that require the |
|
user-modify-playback-state
| Description | Write access to a user’s playback state |
| Visible to users | Control playback on your Spotify clients and Spotify Connect devices. |
|
Endpoints that require the
|
|
user-read-private
| Description | Read access to user’s subscription details (type of user account). |
| Visible to users | Access your subscription details. |
|
Endpoints that require the |
|
user-follow-modify
| Description | Write/delete access to the list of artists and other users that the user follows. |
| Visible to users | Manage who you are following. |
|
Endpoints that require the |
|
user-follow-read
| Description | Read access to the list of artists and other users that the user follows. |
| Visible to users | Access your followers and who you are following. |
|
Endpoints that require the |
|
user-library-modify
| Description | Write/delete access to a user's "Your Music" library. |
| Visible to users | Manage your saved content. |
|
Endpoints that require the |
|
user-library-read
| Description | Read access to a user's library. |
| Visible to users | Access your saved content. |
|
Endpoints that require the |
|
streaming
| Description | Control 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 users | Play content and control playback on your other devices. |
|
Endpoints that require the |
|
user-read-playback-position
| Description | Read access to a user’s playback position in a content. |
| Visible to users | Read your position in content you have played. |
|
Endpoints that require the |
|
playlist-modify-private
| Description | Write access to a user's private playlists. |
| Visible to users | Manage your private playlists. |
|
Endpoints that require the |
|
playlist-read-collaborative
| Description | Include collaborative playlists when requesting a user's playlists. |
| Visible to users | Access your collaborative playlists. |
|
Endpoints that require the |
|
app-remote-control
| Description | Remote control playback of Spotify. This scope is currently available to Spotify iOS and Android SDKs. |
| Visible to users | Communicate with the Spotify app on your device. |
|
Endpoints that require the |
|
user-read-email
| Description | Read access to user’s email address. |
| Visible to users | Get your real email address. |
|
Endpoints that require the |
|
playlist-read-private
| Description | Read access to user's private playlists. |
| Visible to users | Access your private playlists. |
|
Endpoints that require the |
|
user-top-read
| Description | Read access to a user's top artists and tracks. |
| Visible to users | Read your top artists and content. |
|
Endpoints that require the |
|
playlist-modify-public
| Description | Write access to a user's public playlists. |
| Visible to users | Manage your public playlists. |
|
Endpoints that require the |
|
user-read-currently-playing
| Description | Read access to a user’s currently playing content. |
| Visible to users | Read your currently playing content. |
|
Endpoints that require the |
|
user-read-recently-played
| Description | Read access to a user’s recently played tracks. |
| Visible to users | Access your recently played items. |
|
Endpoints that require the |
|