Connectors
Social & Media
Spotify
Music streaming: playlists, tracks, artists, and playback data
Spotify API referenceAPI checked August 18, 2026
- Signs in with
- API token
- Runs on
- Cloud or On-Prem Worker
- Operations
- 108
- Ready-made triggers
- 0
Connect Spotify
- In Neblex open Connect › Connections and click New Connection.
- Search for Spotify and give the connection a clear name.
- Fill in the fields. Secret values are encrypted and never shown again.
- Click Test, then Create Connection.
| Field | What to enter |
|---|---|
| OAuth access tokenRequiredSecret | Spotify OAuth 2.0 access token with the scopes required by the selected operation. |
Use it in a flow
- Open a flow, open the node library and search for Spotify.
- Drag it onto the canvas and choose an Operation and your connection.
- Map the operation's fields from earlier steps, or click Map with Matt.
- Use Test this step to see what it returns, then save.
To start a flow from Spotify without a ready-made trigger: a Poll for changes trigger can check one of its list operations on a schedule and pass on only what is new; if Spotify can send webhooks, a Webhook trigger receives them at its own URL.
Operations
108 operations in 15 groups. Each one is a step you can add to a flow.
Albums10
Check User's Saved Albumscheck_users_saved_albums | GET | Check if one or more albums is already saved in the current Spotify user's 'Your Music' library. |
Get Albumget_an_album | GET | Get Spotify catalog information for a single album. |
Get Album Tracksget_an_albums_tracks | GET | Get Spotify catalog information about an album’s tracks. |
Get New Releasesget_new_releases | GET | Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab). |
Get Several Albumsget_multiple_albums | GET | Get Spotify catalog information for multiple albums identified by their Spotify IDs. |
Get User's Saved Albumsget_users_saved_albums | GET | Get a list of the albums saved in the current Spotify user's 'Your Music' library. |
Remove Users' Saved Albumsremove_albums_user | DELETE | Remove one or more albums from the current user's 'Your Music' library. |
Remove Users' Saved Albumsremove_albums_user_json | DELETE | Remove one or more albums from the current user's 'Your Music' library. |
Save Albums for Current Usersave_albums_user | PUT | Save one or more albums to the current user's 'Your Music' library. |
Save Albums for Current Usersave_albums_user_json | PUT | Save one or more albums to the current user's 'Your Music' library. |
Artists5
Get Artistget_an_artist | GET | Get Spotify catalog information for a single artist identified by their unique Spotify ID. |
Get Artist's Albumsget_an_artists_albums | GET | Get Spotify catalog information about an artist's albums. |
Get Artist's Related Artistsget_an_artists_related_artists | GET | Get Spotify catalog information about artists similar to a given artist. |
Get Artist's Top Tracksget_an_artists_top_tracks | GET | Get Spotify catalog information about an artist's top tracks by country. |
Get Several Artistsget_multiple_artists | GET | Get Spotify catalog information for several artists based on their Spotify IDs. |
Audiobooks7
Check User's Saved Audiobookscheck_users_saved_audiobooks | GET | Check if one or more audiobooks are already saved in the current Spotify user's library. |
Get an Audiobookget_an_audiobook | GET | Get Spotify catalog information for a single audiobook. |
Get Audiobook Chaptersget_audiobook_chapters | GET | Get Spotify catalog information about an audiobook's chapters. |
Get Several Audiobooksget_multiple_audiobooks | GET | Get Spotify catalog information for several audiobooks identified by their Spotify IDs. |
Get User's Saved Audiobooksget_users_saved_audiobooks | GET | Get a list of the audiobooks saved in the current Spotify user's 'Your Music' library. |
Remove User's Saved Audiobooksremove_audiobooks_user | DELETE | Remove one or more audiobooks from the Spotify user's library. |
Save Audiobooks for Current Usersave_audiobooks_user | PUT | Save one or more audiobooks to the current Spotify user's library. |
Categories2
Get Several Browse Categoriesget_categories | GET | Get a list of categories used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab). |
Get Single Browse Categoryget_a_category | GET | Get a single category used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab). |
Chapters2
Get a Chapterget_a_chapter | GET | Get Spotify catalog information for a single audiobook chapter. |
Get Several Chaptersget_several_chapters | GET | Get Spotify catalog information for several audiobook chapters identified by their Spotify IDs. |
Episodes8
Check User's Saved Episodescheck_users_saved_episodes | GET | Check if one or more episodes is already saved in the current Spotify user's 'Your Episodes' library. |
Get Episodeget_an_episode | GET | Get Spotify catalog information for a single episode identified by its unique Spotify ID. |
Get Several Episodesget_multiple_episodes | GET | Get Spotify catalog information for several episodes based on their Spotify IDs. |
Get User's Saved Episodesget_users_saved_episodes | GET | Get a list of the episodes saved in the current Spotify user's library. |
Remove User's Saved Episodesremove_episodes_user | DELETE | Remove one or more episodes from the current user's library. |
Remove User's Saved Episodesremove_episodes_user_json | DELETE | Remove one or more episodes from the current user's library. |
Save Episodes for Current Usersave_episodes_user | PUT | Save one or more episodes to the current user's library. |
Save Episodes for Current Usersave_episodes_user_json | PUT | Save one or more episodes to the current user's library. |
Genres1
Get Available Genre Seedsget_recommendation_genres | GET | Retrieve a list of available genres seed parameter values for recommendations. |
Library3
Check User's Saved Itemscheck_library_contains | GET | Check if one or more items are already saved in the current user's library. |
Remove Items from Libraryremove_library_items | DELETE | Remove one or more items from the current user's library. |
Save Items to Librarysave_library_items | PUT | Add one or more items to the current user's library. |
Markets1
Get Available Marketsget_available_markets | GET | Get the list of markets where Spotify is available. |
Player15
Add Item to Playback Queueadd_to_queue | POST | Add an item to be played next in the user's current playback queue. |
Get Available Devicesget_a_users_available_devices | GET | Get information about a user’s available Spotify Connect devices. |
Get Currently Playing Trackget_the_users_currently_playing_track | GET | Get the object currently being played on the user's Spotify account. |
Get Playback Stateget_information_about_the_users_current_playback | GET | Get information about the user’s current playback state, including track or episode, progress, and active device. |
Get Recently Played Tracksget_recently_played | GET | Get tracks from the current user's recently played tracks. |
Get the User's Queueget_queue | GET | Get the list of objects that make up the user's queue. |
Pause Playbackpause_a_users_playback | PUT | Pause playback on the user's account. |
Seek To Positionseek_to_position_in_currently_playing_track | PUT | Seeks to the given position in the user’s currently playing track. |
Set Playback Volumeset_volume_for_users_playback | PUT | Set the volume for the user’s current playback device. |
Set Repeat Modeset_repeat_mode_on_users_playback | PUT | Set the repeat mode for the user's playback. |
Skip To Nextskip_users_playback_to_next_track | POST | Skips to next track in the user’s queue. |
Skip To Previousskip_users_playback_to_previous_track | POST | Skips to previous track in the user’s queue. |
Start/Resume Playbackstart_a_users_playback | PUT | Start a new context or resume current playback on the user's active device. |
Toggle Playback Shuffletoggle_shuffle_for_users_playback | PUT | Toggle shuffle on or off for user’s playback. |
Transfer Playbacktransfer_a_users_playback | PUT | Transfer playback to a new device and optionally begin playback. |
Playlists23
Add Custom Playlist Cover Imageupload_custom_playlist_cover | PUT | Replace the image used to represent a specific playlist. |
Add Custom Playlist Cover Imageupload_custom_playlist_cover_file | PUT | Replace the image used to represent a specific playlist. |
Add Items to Playlistadd_items_to_playlist | POST | Add one or more items to a user's playlist. |
Add Items to Playlistadd_items_to_playlist_json | POST | Add one or more items to a user's playlist. |
Add Items to Playlist [DEPRECATED]add_tracks_to_playlist | POST | Deprecated: Use Add Items to Playlist instead. |
Add Items to Playlist [DEPRECATED]add_tracks_to_playlist_json | POST | Deprecated: Use Add Items to Playlist instead. |
Change Playlist Detailschange_playlist_details | PUT | Change a playlist's name and public/private state. |
Create Playlistcreate_playlist | POST | Create a playlist for the current Spotify user. |
Create Playlist for usercreate_playlist_for_user | POST | Deprecated : Use Create Playlist instead. |
Get Category's Playlistsget_a_categories_playlists | GET | Get a list of Spotify playlists tagged with a particular category. |
Get Current User's Playlistsget_a_list_of_current_users_playlists | GET | Get a list of the playlists owned or followed by the current Spotify user. |
Get Featured Playlistsget_featured_playlists | GET | Get a list of Spotify featured playlists (shown, for example, on a Spotify player's 'Browse' tab). |
Get Playlistget_playlist | GET | Get a playlist owned by a Spotify user. |
Get Playlist Cover Imageget_playlist_cover | GET | Get the current image associated with a specific playlist. |
Get Playlist Itemsget_playlists_items | GET | Get full details of the items of a playlist owned by a Spotify user. |
Get Playlist Items [DEPRECATED]get_playlists_tracks | GET | Deprecated: Use Get Playlist Items instead. |
Get User's Playlistsget_list_users_playlists | GET | Get a list of the playlists owned or followed by a Spotify user. |
Remove Playlist Itemsremove_items_playlist | DELETE | Remove one or more items from a user's playlist. |
Remove Playlist Items [DEPRECATED]remove_tracks_playlist | DELETE | Deprecated: Use Remove Playlist Items instead. |
Update Playlist Itemsreorder_or_replace_playlists_items | PUT | Either reorder or replace items in a playlist depending on the request's parameters. |
Update Playlist Itemsreorder_or_replace_playlists_items_json | PUT | Either reorder or replace items in a playlist depending on the request's parameters. |
Update Playlist Items [DEPRECATED]reorder_or_replace_playlists_tracks | PUT | Deprecated: Use Update Playlist Items instead. |
Update Playlist Items [DEPRECATED]reorder_or_replace_playlists_tracks_json | PUT | Deprecated: Use Update Playlist Items instead. |
Search1
Search for Itemsearch | GET | Get Spotify catalog information about albums, artists, playlists, tracks, shows, episodes or audiobooks that match a keyword string. |
Shows7
Check User's Saved Showscheck_users_saved_shows | GET | Check if one or more shows is already saved in the current Spotify user's library. |
Get Several Showsget_multiple_shows | GET | Get Spotify catalog information for several shows based on their Spotify IDs. |
Get Showget_a_show | GET | Get Spotify catalog information for a single show identified by its unique Spotify ID. |
Get Show Episodesget_a_shows_episodes | GET | Get Spotify catalog information about an show’s episodes. |
Get User's Saved Showsget_users_saved_shows | GET | Get a list of shows saved in the current Spotify user's library. |
Remove User's Saved Showsremove_shows_user | DELETE | Delete one or more shows from current Spotify user's library. |
Save Shows for Current Usersave_shows_user | PUT | Save one or more shows to current Spotify user's library. |
Tracks11
Check User's Saved Trackscheck_users_saved_tracks | GET | Check if one or more tracks is already saved in the current Spotify user's 'Your Music' library. |
Get Recommendationsget_recommendations | GET | Recommendations are generated based on the available information for a given seed entity and matched against similar artists and tracks. |
Get Several Tracksget_several_tracks | GET | Get Spotify catalog information for multiple tracks based on their Spotify IDs. |
Get Several Tracks' Audio Featuresget_several_audio_features | GET | Get audio features for multiple tracks based on their Spotify IDs. |
Get Trackget_track | GET | Get Spotify catalog information for a single track identified by its unique Spotify ID. |
Get Track's Audio Analysisget_audio_analysis | GET | Get a low-level audio analysis for a track in the Spotify catalog. |
Get Track's Audio Featuresget_audio_features | GET | Get audio feature information for a single track identified by its unique Spotify ID. |
Get User's Saved Tracksget_users_saved_tracks | GET | Get a list of the songs saved in the current Spotify user's 'Your Music' library. |
Remove User's Saved Tracksremove_tracks_user | DELETE | Remove one or more tracks from the current user's 'Your Music' library. |
Remove User's Saved Tracksremove_tracks_user_json | DELETE | Remove one or more tracks from the current user's 'Your Music' library. |
Save Tracks for Current Usersave_tracks_user | PUT | Save one or more tracks to the current user's 'Your Music' library. |
Users12
Check if Current User Follows Playlistcheck_if_user_follows_playlist | GET | Check to see if the current user is following a specified playlist. |
Check If User Follows Artists or Userscheck_current_user_follows | GET | Check to see if the current user is following one or more artists or other Spotify users. |
Follow Artists or Usersfollow_artists_users | PUT | Add the current user as a follower of one or more artists or other Spotify users. |
Follow Artists or Usersfollow_artists_users_json | PUT | Add the current user as a follower of one or more artists or other Spotify users. |
Follow Playlistfollow_playlist | PUT | Add the current user as a follower of a playlist. |
Get Current User's Profileget_current_users_profile | GET | Get detailed profile information about the current user (including the current user's username). |
Get Followed Artistsget_followed | GET | Get the current user's followed artists. |
Get User's Profileget_users_profile | GET | Get public profile information about a Spotify user. |
Get User's Top Itemsget_users_top_artists_and_tracks | GET | Get the current user's top artists or tracks based on calculated affinity. |
Unfollow Artists or Usersunfollow_artists_users | DELETE | Remove the current user as a follower of one or more artists or other Spotify users. |
Unfollow Artists or Usersunfollow_artists_users_json | DELETE | Remove the current user as a follower of one or more artists or other Spotify users. |
Unfollow Playlistunfollow_playlist | DELETE | Remove the current user as a follower of a playlist. |