- Category: news & lifestyle
- Auth: OAUTH2
- Composio-managed OAuth available? No
- Tools: 88
- Triggers: 3
- Slug:
SPOTIFY - Version: 20261101_00
Frequently Asked Questions
Why is there no default OAuth app for Spotify?
Why is there no default OAuth app for Spotify?
Tools
Add items to playlist
Add items to playlist
SPOTIFY_ADD_ITEMS_TO_PLAYLISTAdd one or more items to a user’s playlist.Input Parameters
Output
Add item to playback queue
Add item to playback queue
SPOTIFY_ADD_ITEM_TO_PLAYBACK_QUEUEAdd an item to the end of the user’s current playback queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints. Required scope: user-modify-playback-state Note: Only tracks and episodes can be added to the queue. Albums and playlists cannot be added directly.Input Parameters
Output
Change playlist details
Change playlist details
SPOTIFY_CHANGE_PLAYLIST_DETAILSChange a playlist’s name and public/private state. The user must own the playlist. This action allows updating the playlist name, description, public/private status, and collaborative mode. At least one of the optional parameters (name, public, collaborative, description) must be provided. Important constraints: - collaborative can only be set to true on non-public playlists (when public is false) - Requires OAuth scope: playlist-modify-public (for public playlists) or playlist-modify-private (for private playlists) - The playlist must be owned by the authenticated userInput Parameters
Output
Check if user follows artists or users
Check if user follows artists or users
SPOTIFY_CHECK_IF_USER_FOLLOWS_ARTISTS_OR_USERSCheck whether the current user follows up to 50 specified artists or Spotify users. Results indicate follow status in the order of the supplied IDs; the user-follow-read scope is required. DEPRECATED: This endpoint is unavailable to affected Development Mode apps; use GET /me/library/contains with Spotify URIs instead.Input Parameters
Output
Check if users follow playlist
Check if users follow playlist
SPOTIFY_CHECK_IF_USERS_FOLLOW_PLAYLISTCheck whether the authenticated user follows a specified public or owned Spotify playlist. The result contains a boolean follow status; arbitrary users cannot be checked. DEPRECATED: This endpoint is unavailable to apps subject to updated Development Mode restrictions; use GET /me/library/contains with a Spotify URI instead.Input Parameters
Output
Check user s saved albums
Check user s saved albums
SPOTIFY_CHECK_USER_S_SAVED_ALBUMSCheck whether up to 20 albums, identified by Spotify ID, are saved in the current user’s library. Returns a boolean for each album in request order and requires user-library-read. DEPRECATED: This endpoint is unavailable under updated Development Mode restrictions; use GET /me/library/contains with Spotify URIs instead.Input Parameters
Output
Check user s saved audiobooks
Check user s saved audiobooks
SPOTIFY_CHECK_USER_S_SAVED_AUDIOBOOKSCheck whether up to 50 audiobooks, identified by Spotify ID, are saved in the current user’s library. Returns a boolean for each audiobook and requires user-library-read. DEPRECATED: The legacy endpoint is unavailable under updated Development Mode restrictions; use GET /me/library/contains with Spotify URIs instead. Extended Quota Mode apps are unaffected.Input Parameters
Output
Check User's Saved Episodes
Check User's Saved Episodes
SPOTIFY_CHECK_USER_S_SAVED_EPISODESCheck whether up to 50 podcast episodes by ID are saved in the current user’s Your Episodes library. Returns boolean results in the order requested and requires user-library-read. DEPRECATED: The legacy endpoint is unavailable under updated Development Mode restrictions; use GET /me/library/contains with Spotify URIs instead. Extended Quota Mode apps are unaffected.Input Parameters
Output
Check user's saved shows
Check user's saved shows
SPOTIFY_CHECK_USER_S_SAVED_SHOWSCheck whether up to 50 shows, identified by Spotify ID, are saved in the current user’s library. Returns a boolean for each show in request order and requires user-library-read. DEPRECATED: This endpoint is unavailable under updated Development Mode restrictions; use GET /me/library/contains with Spotify URIs instead.Input Parameters
Output
Check User's Saved Tracks
Check User's Saved Tracks
SPOTIFY_CHECK_USER_S_SAVED_TRACKSCheck whether up to 50 tracks, identified by Spotify track ID, are saved in the current user’s library. Returns a boolean for each ID in request order and requires user-library-read. DEPRECATED: The legacy endpoint is unavailable to affected Development Mode apps; use GET /me/library/contains with Spotify URIs instead.Input Parameters
Output
Create playlist
Create playlist
SPOTIFY_CREATE_PLAYLISTCreate an empty playlist for a Spotify user, with a name and optional description, visibility, and collaboration settings. The appropriate playlist-modify permission is required. DEPRECATED: The user-specific endpoint is unavailable to affected Development Mode apps; use POST /me/playlists to create a playlist for the current user instead.Input Parameters
"Your Coolest Playlist". This name does not need to be unique; a user may have several playlists with the same name.true. If true the playlist will be public, if false it will be private. To be able to create private playlists, the user must have granted the playlist-modify-private scopefalse. If true the playlist will be collaborative. Note*: to create a collaborative playlist you must also set public to false. To create collaborative playlists you must have granted playlist-modify-private and playlist-modify-public scopes.*Output
Follow artists or users
Follow artists or users
SPOTIFY_FOLLOW_ARTISTS_OR_USERSFollow one or more artists or Spotify users by ID for the current authenticated user, adding them to the user’s following list. Requires user-follow-modify; up to 50 IDs can be supplied. DEPRECATED: The legacy endpoint is unavailable to affected Development Mode apps; Spotify recommends PUT /me/library with Spotify URIs instead.Input Parameters
Output
Follow playlist
Follow playlist
SPOTIFY_FOLLOW_PLAYLISTFollow a playlist for the current Spotify user by playlist ID, publicly or privately. Requires playlist-modify-public or playlist-modify-private as appropriate. DEPRECATED: The legacy endpoint is unavailable under updated Development Mode restrictions; use PUT /me/library with a Spotify URI instead. Extended Quota Mode apps are unaffected.Input Parameters
true. If true the playlist will be included in user’s public playlists, if false it will remain private.Output
Get a chapter
Get a chapter
SPOTIFY_GET_A_CHAPTERGet Spotify catalog information for a single audiobook chapter including name, description, duration, release date, narrators, and playback information. Audiobook chapters are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets. Use this action to retrieve detailed metadata about a specific chapter when you have its Spotify ID.Input Parameters
Output
Get Album Details
Get Album Details
SPOTIFY_GET_ALBUMGet Spotify catalog information for a single album by ID, including metadata, track listing, artist information and cover artwork. Popularity and available markets may be absent for Development Mode apps.Input Parameters
Output
Get album tracks
Get album tracks
SPOTIFY_GET_ALBUM_TRACKSGet Spotify catalog information about an album’s tracks. Optional parameters can be used to limit the number of tracks returned.Input Parameters
Output
Get an audiobook
Get an audiobook
SPOTIFY_GET_AN_AUDIOBOOKGet Spotify catalog information for a single audiobook. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.Input Parameters
Output
Get artist
Get artist
SPOTIFY_GET_ARTISTGet detailed Spotify catalog information for a single artist, including name, genres, profile images and Spotify links. Follower count and popularity may be absent for Development Mode apps.Input Parameters
Output
Get artist s albums
Get artist s albums
SPOTIFY_GET_ARTIST_S_ALBUMSGet Spotify catalog information about an artist’s albums.Input Parameters
Output
Get Artist's Top Tracks
Get Artist's Top Tracks
SPOTIFY_GET_ARTIST_S_TOP_TRACKSGet Spotify catalog information about an artist’s top tracks in a specified market, defaulting to the US. DEPRECATED: Spotify removed this endpoint for affected Development Mode apps and documents no replacement.Input Parameters
Output
Get audiobook chapters
Get audiobook chapters
SPOTIFY_GET_AUDIOBOOK_CHAPTERSGet Spotify catalog information about an audiobook’s chapters. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.Input Parameters
Output
Get Available Devices
Get Available Devices
SPOTIFY_GET_AVAILABLE_DEVICESGet information about the user’s available Spotify Connect devices. Returns a list of devices that can be used for playback, including their names, types (computer, smartphone, speaker), active status, volume levels, and whether they support API control. Useful for checking available playback targets before transferring playback or controlling volume. Requires the ‘user-read-playback-state’ scope. Note: Some device models are not supported and will not be listed in the API response.Output
Get available genre seeds
Get available genre seeds
SPOTIFY_GET_AVAILABLE_GENRE_SEEDSGet available genre seeds for Spotify recommendations. Returns a list of genre strings that can be used as seed_genres parameter when requesting music recommendations. These genres represent the full set of available genre seeds on Spotify. No parameters are required for this endpoint. Note: This endpoint is deprecated but still functional as of the current API version.Output
Get available markets
Get available markets
Get Category's Playlists
Get Category's Playlists
SPOTIFY_GET_CATEGORY_S_PLAYLISTSGet Spotify playlists tagged with a specific category (e.g., ‘workout’, ‘party’, ‘dinner’). Returns a paginated list of playlists for the specified category. Use the limit and offset parameters to control pagination. Category IDs can be obtained from the Get Several Browse Categories endpoint. NOTE: This endpoint is deprecated as of November 2024 and may return 403 Forbidden for apps without extended quota access that was approved before November 27, 2024. Consider alternative endpoints for new implementations.Input Parameters
Output
Get currently playing track
Get currently playing track
SPOTIFY_GET_CURRENTLY_PLAYING_TRACKGet the object currently being played on the user’s Spotify account.Input Parameters
Output
Get current user s playlists
Get current user s playlists
SPOTIFY_GET_CURRENT_USER_S_PLAYLISTSGet a paginated list of playlists owned or followed by the current Spotify user, with playlist metadata and pagination links. In updated Development Mode, track counts may be absent from the returned playlist objects.Input Parameters
Output
Get current user s profile
Get current user s profile
SPOTIFY_GET_CURRENT_USER_S_PROFILEGet profile information for the current authenticated Spotify user, including available display name, images and Spotify URIs. Email, country, subscription level, explicit content settings and follower count are unavailable under updated Development Mode restrictions.Output
Get episode
Get episode
SPOTIFY_GET_EPISODEGet Spotify catalog information for a single podcast episode identified by its unique Spotify ID. This endpoint retrieves detailed information about a podcast episode including its name, description, duration, release date, cover art, show information, and playback status. It can also return the user’s resume point if the user-read-playback-position scope is authorized. Episodes are podcast content on Spotify. Use this endpoint to get metadata and playback information for a specific episode when you have its Spotify ID.Input Parameters
Output
Get featured playlists
Get featured playlists
SPOTIFY_GET_FEATURED_PLAYLISTSGet a list of Spotify’s editorially curated featured playlists. These are the playlists shown on a Spotify player’s ‘Browse’ tab and are updated regularly by Spotify’s editorial team. The response includes a localized message and a paginated list of simplified playlist objects.Input Parameters
Output
Get followed artists
Get followed artists
SPOTIFY_GET_FOLLOWED_ARTISTSGet a cursor-paginated list of artists followed by the current Spotify user using the after parameter; requires user-follow-read. Under updated Development Mode restrictions, follower counts and popularity are unavailable, and missing popularity is represented as zero.Input Parameters
Output
Get new releases
Get new releases
SPOTIFY_GET_NEW_RELEASESGet a page of new album releases featured by Spotify, such as those shown in Browse. Use limit and offset to page through releases; the limit is 1–50 and defaults to 20. DEPRECATED: Spotify removed this endpoint for apps subject to updated Development Mode restrictions.Input Parameters
Output
Get playback state
Get playback state
SPOTIFY_GET_PLAYBACK_STATEGet the current user’s Spotify playback state, including the active device, current track or episode, progress, playback context, and repeat and shuffle settings. Requires user-read-playback-state. When no playback is active, the action returns a no-active-playback message.Input Parameters
Output
Get playlist
Get playlist
SPOTIFY_GET_PLAYLISTGet metadata and available contents of a Spotify playlist, with optional field filtering. For affected Development Mode apps, playlist contents are returned only for playlists the user owns or collaborates on, and use the items field.Input Parameters
Output
Get playlist cover image
Get playlist cover image
Get playlist items
Get playlist items
SPOTIFY_GET_PLAYLIST_ITEMSGet a paginated list of tracks or episodes in a playlist, with optional response field filtering. For affected Development Mode apps, playlist items are available only for playlists the user owns or collaborates on.Input Parameters
Output
Get recently played tracks
Get recently played tracks
SPOTIFY_GET_RECENTLY_PLAYED_TRACKSGet tracks from the current user’s recently played tracks. Note*: Currently doesn’t support podcast episodes.*Input Parameters
Output
Get recommendations
Get recommendations
SPOTIFY_GET_RECOMMENDATIONSGet track recommendations based on seed artists, genres, and/or tracks. At least one seed is required (up to 5 total). Optionally tune recommendations with audio feature parameters (acousticness, danceability, energy, etc.). IMPORTANT: This endpoint requires Spotify Extended API Access (restricted since Nov 27, 2024). Accounts without extended access will receive a 404 error. See: https://developer.spotify.com/blog/2024-11-27-changes-to-the-web-api Returns a list of recommended tracks with full track metadata including artists, album info, and audio features.Input Parameters
Output
Get several albums
Get several albums
SPOTIFY_GET_SEVERAL_ALBUMSGet Spotify catalog information for up to 20 albums by Spotify ID, optionally specifying a market. DEPRECATED: The batch endpoint is unavailable to affected Development Mode apps; fetch albums individually using GET /albums/{id} instead.Input Parameters
Output
Get several artists
Get several artists
SPOTIFY_GET_SEVERAL_ARTISTSGet Spotify catalog information for up to 50 artists in one request using their Spotify IDs. DEPRECATED: The batch endpoint is unavailable to affected Development Mode apps; retrieve artists individually using GET /artists/{id} instead.Input Parameters
Output
Get several audiobooks
Get several audiobooks
SPOTIFY_GET_SEVERAL_AUDIOBOOKSGet Spotify catalog information for up to 50 audiobooks by ID in a single request, optionally specifying a market. Unavailable or nonexistent audiobooks appear as null in the results. DEPRECATED: The batch endpoint is unavailable to affected Development Mode apps; use GET /audiobooks/{id} for each audiobook instead.Input Parameters
Output
Get several browse categories
Get several browse categories
Get several chapters
Get several chapters
SPOTIFY_GET_SEVERAL_CHAPTERSGet Spotify catalog details for up to 50 audiobook chapters by ID, including chapter metadata and parent audiobook information. This action is currently unavailable. DEPRECATED: The batch endpoint is unavailable under updated Development Mode restrictions; fetch chapters individually with GET /chapters/{id} instead. Extended Quota Mode apps are unaffected.Input Parameters
Output
Get several episodes
Get several episodes
SPOTIFY_GET_SEVERAL_EPISODESGet Spotify catalog information for up to 50 episodes by their IDs in a single request, with an optional market. DEPRECATED: The batch endpoint is unavailable to affected Development Mode apps; use GET /episodes/{id} for each episode instead.Input Parameters
Output
Get several shows
Get several shows
SPOTIFY_GET_SEVERAL_SHOWSGet Spotify catalog information for up to 50 shows by ID in a single request, optionally specifying a market. DEPRECATED: The batch endpoint is unavailable to affected Development Mode apps; use GET /shows/{id} for each show instead.Input Parameters
Output
Get several tracks
Get several tracks
SPOTIFY_GET_SEVERAL_TRACKSGet Spotify catalog information for multiple tracks by Spotify ID, with an optional market. DEPRECATED: The batch endpoint is unavailable to affected Development Mode apps; fetch tracks individually using GET /tracks/{id} instead.Input Parameters
Output
Get several tracks audio features
Get several tracks audio features
SPOTIFY_GET_SEVERAL_TRACKS_AUDIO_FEATURESGet audio features for multiple tracks based on their Spotify IDs. Returns audio feature information for multiple tracks including danceability, energy, loudness, speechiness, acousticness, instrumentalness, liveness, valence, tempo, and other musical attributes. Note: This endpoint was deprecated by Spotify on November 27, 2024. Applications created or approved after this date will receive 403 Forbidden errors. Only applications with existing extended mode Web API access that were relying on this endpoint before the cutoff date remain unaffected.Input Parameters
Output
Get show
Get show
SPOTIFY_GET_SHOWGet Spotify catalog information for a single show (podcast) identified by its unique Spotify ID.Input Parameters
Output
Get show episodes
Get show episodes
SPOTIFY_GET_SHOW_EPISODESGet Spotify catalog information about a show’s episodes. Optional parameters can be used to limit the number of episodes returned. This endpoint retrieves a paginated list of episodes for a specific podcast/show.Input Parameters
Output
Get single browse category
Get single browse category
SPOTIFY_GET_SINGLE_BROWSE_CATEGORYGet information about a Spotify browse category by ID, including its name and icons, with an optional locale. DEPRECATED: This endpoint is unavailable to affected Development Mode apps; Spotify recommends removing features that use browse categories.Input Parameters
Output
Get the user's queue
Get the user's queue
SPOTIFY_GET_THE_USER_S_QUEUEGet the list of tracks and episodes in the user’s playback queue. Returns the currently playing track/episode and the queue of upcoming items. This is a read-only operation that does not modify the queue. Requirements: - Spotify Premium subscription required - Requires one of these OAuth scopes: - user-read-currently-playing - user-read-playback-state - An active Spotify session (user must be logged in on a device) Returns: - currently_playing: The track or episode currently playing (may be null) - queue: List of tracks/episodes queued for playback (may be empty) Common errors: - 403 Forbidden: Premium subscription required or insufficient OAuth scopes - 204 No Content: No active playback sessionOutput
Get track
Get track
Get Track's Audio Analysis
Get Track's Audio Analysis
SPOTIFY_GET_TRACK_S_AUDIO_ANALYSISGet a comprehensive audio analysis for a Spotify track. Returns detailed structural and musical characteristics including: - Meta information (analyzer version, timestamp, processing time) - Track properties (tempo, key, mode, time signature, loudness, duration) - Temporal structure (bars, beats, sections, tatums) - Segments with pitch content and timbre characteristics All timing values are in seconds. Confidence scores range from 0.0 to 1.0. Useful for music analysis, visualization, and recommendation systems.Input Parameters
Output
Get track's audio features
Get track's audio features
SPOTIFY_GET_TRACK_S_AUDIO_FEATURESGet audio feature information for a single track identified by its unique Spotify ID. Note: This endpoint was deprecated by Spotify on November 27, 2024. Applications created or approved after this date will receive 403 Forbidden errors. Only applications with existing extended mode Web API access that were relying on this endpoint before the cutoff date remain unaffected.Input Parameters
Output
Get user's playlists
Get user's playlists
SPOTIFY_GET_USER_S_PLAYLISTSGet a paginated list of playlists owned or followed by a specified Spotify user, using limit and offset. Access to private or collaborative playlists requires the appropriate authorization and scopes. DEPRECATED: This endpoint is unavailable to affected Development Mode apps; Spotify provides GET /me/playlists for the current user, but no replacement for other users’ playlists.Input Parameters
Output
Get user's profile
Get user's profile
SPOTIFY_GET_USER_S_PROFILERetrieve public profile information for a Spotify user by user ID, such as their display name and profile images. DEPRECATED: The specified-user profile endpoint is unavailable to affected Development Mode apps. Spotify provides GET /me for the current user’s profile, but no replacement for another user’s profile.Input Parameters
Output
Get user s saved albums
Get user s saved albums
SPOTIFY_GET_USER_S_SAVED_ALBUMSGet a list of albums saved in the current Spotify user’s library (‘Your Music’). Returns a paginated list of albums that the user has saved to their library, including when each album was added and full album details (tracks, artists, images, etc.). Supports pagination via limit and offset parameters, and can filter by market availability. Required OAuth scope: user-library-readInput Parameters
Output
Get user s saved audiobooks
Get user s saved audiobooks
Get user's saved episodes
Get user's saved episodes
SPOTIFY_GET_USER_S_SAVED_EPISODESGet a list of episodes saved in the current Spotify user’s library. This endpoint retrieves a paginated list of podcast episodes that the authenticated user has saved to their Spotify library. Each item in the response includes the full episode details and the timestamp when it was added to the library. Required OAuth Scopes: - user-library-read: Access your saved content - user-read-playback-position: Read your position in content you have played (for resume_point) Note: This endpoint is currently in beta and may change without warning. Please share feedback or issues in the Spotify developer community forum.Input Parameters
Output
Get User's Saved Shows
Get User's Saved Shows
SPOTIFY_GET_USER_S_SAVED_SHOWSGet a list of shows saved in the current Spotify user’s library. Optional parameters can be used to limit the number of shows returned.Input Parameters
Output
Get User's Saved Tracks
Get User's Saved Tracks
SPOTIFY_GET_USER_S_SAVED_TRACKSGet a list of the songs saved in the current Spotify user’s ‘Your Music’ library. Returns paginated results with track details including album info, artists, duration, and when each track was saved.Input Parameters
Output
Get User's Top Artists
Get User's Top Artists
SPOTIFY_GET_USER_S_TOP_ARTISTSGet a paginated list of the current user’s top artists based on listening affinity over a selected time range; requires user-top-read. Artist details may include genres, images, popularity, and follower counts.Input Parameters
Output
Get User's Top Tracks
Get User's Top Tracks
SPOTIFY_GET_USER_S_TOP_TRACKSGet the current user’s top tracks based on listening affinity over a selected time range. Supports limit and offset pagination and requires the user-top-read scope. This action is currently unavailable.Input Parameters
Output
Pause playback
Pause playback
SPOTIFY_PAUSE_PLAYBACKPause playback on the user’s account. Pauses playback on the currently active device or on a specified device. Returns immediately with success when playback is paused. If no device is specified, the currently active device will be paused. Requirements: - Spotify Premium subscription - OAuth scope: user-modify-playback-state - Active playback session Note: The order of execution is not guaranteed when you use this API with other Player API endpoints. If playback is already paused, this action will still succeed (idempotent). Common scenarios: - Pause current playback: Call with no parameters - Pause specific device: Provide device_id parameter Error scenarios: - 403: User does not have Spotify Premium - 404: No active device foundInput Parameters
Output
Remove playlist items
Remove playlist items
SPOTIFY_REMOVE_PLAYLIST_ITEMSRemove one or more items from a user’s playlist. This endpoint removes tracks or episodes from a playlist. You can remove items by URI (removes all occurrences) or by URI + positions (removes specific occurrences). Requires ‘playlist-modify-public’ scope for public playlists or ‘playlist-modify-private’ scope for private playlists.Input Parameters
Output
Remove users saved albums
Remove users saved albums
SPOTIFY_REMOVE_USERS_SAVED_ALBUMSRemove one or more albums from the current user’s saved library. Removing an album that is not saved does not cause an error. Requires user-library-modify. DEPRECATED: The album-specific endpoint is unavailable to apps subject to updated Development Mode restrictions; use DELETE /me/library with Spotify URIs instead.Input Parameters
Output
Remove User's Saved Audiobooks
Remove User's Saved Audiobooks
SPOTIFY_REMOVE_USER_S_SAVED_AUDIOBOOKSRemove one or more saved audiobooks from the current user’s Spotify library by ID. Supply up to 50 IDs as a list or comma-separated string; user-library-modify is required. DEPRECATED: This legacy endpoint is unavailable to affected Development Mode apps; use DELETE /me/library with Spotify URIs instead.Input Parameters
Output
Remove user's saved episodes
Remove user's saved episodes
SPOTIFY_REMOVE_USER_S_SAVED_EPISODESRemove up to 50 episodes by ID from the current user’s Your Episodes library; removing an unsaved episode succeeds. Requires user-library-modify. This action is currently unavailable. DEPRECATED: Spotify replaced the legacy endpoint with DELETE /me/library for affected Development Mode apps; Extended Quota Mode apps are unaffected.Input Parameters
Output
Remove user s saved shows
Remove user s saved shows
SPOTIFY_REMOVE_USER_S_SAVED_SHOWSRemove one or more shows by Spotify ID from the current user’s library. Requires the user-library-modify scope. DEPRECATED: This show-specific endpoint is unavailable to affected Development Mode apps; use DELETE /me/library with Spotify URIs instead.Input Parameters
Output
Remove user s saved tracks
Remove user s saved tracks
SPOTIFY_REMOVE_USER_S_SAVED_TRACKSRemove one or more tracks by Spotify ID from the current user’s library. Requires the user-library-modify scope. DEPRECATED: The track-specific endpoint is unavailable to apps subject to updated Development Mode restrictions; use DELETE /me/library with Spotify URIs instead.Input Parameters
Output
Save albums for current user
Save albums for current user
SPOTIFY_SAVE_ALBUMS_FOR_CURRENT_USERSave one or more albums by Spotify ID to the current user’s library. Requires the user-library-modify scope; saving an already saved album is idempotent. DEPRECATED: This album-specific endpoint is unavailable to affected Development Mode apps; use PUT /me/library with Spotify URIs instead.Input Parameters
Output
Save audiobooks for current user
Save audiobooks for current user
SPOTIFY_SAVE_AUDIOBOOKS_FOR_CURRENT_USERSave up to 50 audiobooks by Spotify ID to the current user’s library for later access. Requires the user-library-modify scope. DEPRECATED: Spotify removed this audiobook-specific endpoint for apps subject to updated Development Mode restrictions; use PUT /me/library with Spotify URIs instead.Input Parameters
Output
Save episodes for current user
Save episodes for current user
SPOTIFY_SAVE_EPISODES_FOR_CURRENT_USERSave up to 50 podcast episodes by Spotify ID to the current user’s Your Episodes library for later playback. Saving an already saved episode succeeds; the user-library-modify scope is required. DEPRECATED: This legacy endpoint is unavailable to affected Development Mode apps; use PUT /me/library with Spotify URIs instead. Extended Quota Mode apps retain the legacy endpoint.Input Parameters
Output
Save shows for current user
Save shows for current user
SPOTIFY_SAVE_SHOWS_FOR_CURRENT_USERSave up to 50 shows by Spotify ID to the current user’s library. Requires the user-library-modify scope. DEPRECATED: This endpoint is unavailable to affected Development Mode apps; use PUT /me/library with Spotify URIs instead.Input Parameters
Output
Save tracks for current user
Save tracks for current user
SPOTIFY_SAVE_TRACKS_FOR_CURRENT_USERSave tracks to the current user’s Spotify library using up to 50 track IDs or timestamped IDs. Requires user-library-modify. DEPRECATED: This legacy endpoint is unavailable to affected Development Mode apps; use PUT /me/library with Spotify URIs instead.Input Parameters
Output
Search for item
Search for item
SPOTIFY_SEARCH_FOR_ITEMSearch Spotify’s catalog for albums, artists, playlists, tracks, shows, episodes or audiobooks matching a keyword. The default limit is 20; affected Development Mode apps must specify a limit of at most 10 and can paginate using offset. Audiobooks are available only in the US, UK, Canada, Ireland, New Zealand and Australia markets.Input Parameters
Output
Seek to position
Seek to position
SPOTIFY_SEEK_TO_POSITIONSeek to a position in milliseconds in the user’s currently playing track, targeting a specified device or the active device by default. A position beyond the track duration skips to the next track. Requires Spotify Premium and the user-modify-playback-state scope; execution order with other Player API commands is not guaranteed.Input Parameters
Output
Set playback volume
Set playback volume
SPOTIFY_SET_PLAYBACK_VOLUMESet the volume for the user’s current playback device. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.Input Parameters
Output
Set repeat mode
Set repeat mode
SPOTIFY_SET_REPEAT_MODESet the repeat mode for the user’s playback. Controls whether playback should repeat the current track, the current context (playlist, album, etc.), or not repeat at all. The change takes effect immediately on the user’s active device. Requirements: - Spotify Premium subscription - OAuth scope: user-modify-playback-state - Active playback session Valid repeat modes: - “track”: Repeat the current track continuously - “context”: Repeat the current context (playlist/album/etc.) - “off”: Turn repeat off Note: The order of execution is not guaranteed when you use this API with other Player API endpoints. This action is idempotent - setting the same repeat mode multiple times has the same effect as setting it once. Common scenarios: - Turn off repeat: {“state”: “off”} - Repeat current track: {“state”: “track”} - Repeat playlist/album: {“state”: “context”} - Target specific device: {“state”: “off”, “device_id”: “abc123”} Error scenarios: - 403: User does not have Spotify Premium - 404: No active device foundInput Parameters
Output
Skip to next
Skip to next
SPOTIFY_SKIP_TO_NEXTSkips to next track in the user’s queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.Input Parameters
Output
Skip to previous
Skip to previous
SPOTIFY_SKIP_TO_PREVIOUSSkips to the previous track in the user’s queue. Requirements: - Spotify Premium subscription - Active playback (user must be currently playing music) - Requires ‘user-modify-playback-state’ scope Note: The order of execution is not guaranteed when you use this API with other Player API endpoints.Input Parameters
Output
Start resume playback
Start resume playback
SPOTIFY_START_RESUME_PLAYBACKStart playback of a context or list of tracks, or resume playback on a Spotify device. Requires Spotify Premium and the user-modify-playback-state scope; execution order relative to other Player API endpoints is not guaranteed.Input Parameters
Output
Toggle playback shuffle
Toggle playback shuffle
SPOTIFY_TOGGLE_PLAYBACK_SHUFFLEToggle shuffle on or off for user’s playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints. Required OAuth scope: user-modify-playback-state Note: This endpoint returns 204 No Content on success, 404 if no active device is found, and 403 if the user does not have an active Spotify Premium subscription.Input Parameters
Output
Transfer playback
Transfer playback
SPOTIFY_TRANSFER_PLAYBACKTransfer playback to a new device and optionally begin playback. Requires Spotify Premium and the user-modify-playback-state scope; execution order relative to other Player API endpoints is not guaranteed.Input Parameters
Output
Unfollow artists or users
Unfollow artists or users
SPOTIFY_UNFOLLOW_ARTISTS_OR_USERSUnfollow up to 50 artists or Spotify users by ID for the current user, removing them from the following list. Requires user-follow-modify; unfollowing an already-unfollowed account succeeds. DEPRECATED: The legacy endpoint is unavailable under updated Development Mode restrictions; use DELETE /me/library with Spotify URIs instead. Extended Quota Mode apps are unaffected.Input Parameters
Output
Unfollow playlist
Unfollow playlist
SPOTIFY_UNFOLLOW_PLAYLISTUnfollow a playlist by ID for the current user, removing it from their followed playlists. The operation succeeds if the user is not already following it and requires the appropriate playlist-modify scope. DEPRECATED: The legacy endpoint is unavailable to affected Development Mode apps; use DELETE /me/library with a Spotify URI instead.Input Parameters
Output
Update playlist items
Update playlist items
SPOTIFY_UPDATE_PLAYLIST_ITEMSEither replace all tracks in a playlist OR reorder existing tracks within it. REPLACE mode: Use uris parameter to completely overwrite all tracks in the playlist. Example: Replace all tracks with 3 specific tracks. REORDER mode: Use range_start, insert_before, and optionally range_length/snapshot_id to move tracks within the playlist without adding/removing any. Example: Move tracks at positions 5-7 to the beginning of the playlist. These two modes are mutually exclusive - you cannot use both in the same request.Input Parameters
uris parameter.uris parameter.range_start. Defaults to 1 if not specified. Example: range_length=2 means move 2 tracks. NOTE: Cannot be used with uris parameter.uris parameter.