Spotify
Utilities & PersonalConnect over OAuth2 to search the Spotify catalog, read track, album, and artist details, manage playlists and the Liked Songs library, and control playback on a user device.
What This Integration Enables
The Spotify connector gives agents broad reach across catalog, playlists, library, and playback. Agents search the catalog and read track, album, and artist detail including top tracks. They read the current user's playlists, create playlists, add and remove items, and update playlist details. They read the Liked Songs library and save or remove tracks, read the user profile and top items, and, on a Premium account with an active device, read and control playback. Track, album, and artist parameters accept an id, URI, or open.spotify.com URL interchangeably. Some actions read and some write; the connector supplies both, and the surrounding flow decides what publishes to a shared account and what needs a person.
Without FlowRunner
With FlowRunner
Use Case Scenarios
Themed Playlist Building
The agent calls Search to find tracks matching a theme, reads each match, and assembles a proposed set for a shared playlist. It presents the candidates for review, and on approval calls Add Items to Playlist so the playlist grows without anyone dragging tracks in one at a time.
Listening-Trends Report
On a schedule, the agent calls Get User Top Items to pull the account's top tracks and artists over a chosen time range, then appends them to a listening-trends view. The report shows how taste shifts over weeks without exporting screens by hand.
New-Music Digest
The agent reads the latest additions to the Liked Songs library with Get Saved Tracks and posts a digest of new music to a community channel. The digest keeps followers current on what has been saved, drawn straight from the library rather than compiled manually.
Human-in-Loop Highlight
Searching the catalog and reading a playlist are safe, private reads. Adding or removing tracks on a shared or brand playlist is a public act, because every follower sees the result the moment it lands. This is [human-in-the-loop](/concepts/human-in-the-loop/) at the boundary between proposing a change and publishing it to an account other people follow: before writing to a shared playlist or the account's saved library, the agent pauses, assembles the exact tracks it would add or remove, and routes to a person through their preferred channel. The message is specific: "This would add 8 tracks to the followed New Releases playlist, including two by an artist already on it. Approve the additions, or trim the list?" The agent handles the search, the matching, and the assembly; a person owns every change that reaches a shared audience.
Agent Capabilities
27 actionsSearch
1- Search Search the Spotify catalog for tracks, albums, artists, playlists, shows, episodes, or audiobooks matching a query, across one or more item types with an optional market and result limit.
Catalog
6- Get Album Retrieve catalog information for a single album, including name, artists, release date, total tracks, images, genres, label, and the first page of its tracks.
- Get Album Tracks Retrieve the tracks of an album, paginated, as simplified track objects plus a paging object with the total and next offset.
- Get Artist Retrieve catalog information for a single artist, including name, genres, popularity, follower count, and images.
- Get Artist Albums Retrieve the albums released by an artist, paginated, with an optional filter by album group such as Album, Single, or Compilation.
- Get Artist Top Tracks Retrieve an artist top tracks for a given market, which Spotify requires for this endpoint, returning up to ten full track objects ordered by popularity.
- Get Track Retrieve catalog information for a single track, including name, artists, album, duration, popularity, and preview URL.
Playlists
7- Add Items to Playlist Add one or more tracks to a playlist, optionally at a specific position, and receive the playlist new snapshot id. Requires the appropriate playlist-modify scope.
- Create Playlist Create a new playlist owned by the current user. Requires the playlist-modify-public scope for public playlists and playlist-modify-private for private ones.
- Get Current User Playlists Retrieve the playlists owned or followed by the current user, paginated, as simplified playlist objects plus a paging object.
- Get Playlist Retrieve a playlist by id, including its name, owner, description, images, follower count, and the first page of tracks.
- Get Playlist Items Retrieve the items of a playlist, paginated, each wrapping the track plus who added it and when, with a paging object.
- Remove Items from Playlist Remove all occurrences of one or more tracks from a playlist and receive the playlist new snapshot id. Requires the appropriate playlist-modify scope.
- Update Playlist Details Update the name, public or private state, collaborative flag, and description of a playlist owned by the current user. Requires the appropriate playlist-modify scope.
Library
3- Get Saved Tracks Retrieve the tracks saved in the current user Liked Songs library, paginated. Requires the user-library-read scope.
- Remove Saved Tracks Remove one or more tracks from the current user Liked Songs library. Requires the user-library-modify scope.
- Save Tracks Save one or more tracks to the current user Liked Songs library. Requires the user-library-modify scope.
Player
8- Get Currently Playing Retrieve the track or episode currently playing for the connected user. Requires the user-read-currently-playing scope.
- Get Playback State Retrieve the current playback state of the connected user, including the active device, current track, shuffle and repeat state, and progress. Requires Spotify Premium.
- Pause Playback Pause playback on the active or a specified device. Requires Spotify Premium and the user-modify-playback-state scope.
- Set Volume Set the playback volume for the active or a specified device. Requires Spotify Premium and the user-modify-playback-state scope.
- Skip to Next Skip to the next track in the playback queue. Requires Spotify Premium and the user-modify-playback-state scope.
- Skip to Previous Skip to the previous track in the playback queue. Requires Spotify Premium and the user-modify-playback-state scope.
- Start or Resume Playback Start or resume playback on the active or a specified device, given a context URI or a list of track URIs. Requires Spotify Premium and the user-modify-playback-state scope.
- Transfer Playback Transfer playback to a different device, optionally starting immediately. Requires Spotify Premium and the user-modify-playback-state scope.
User
2- Get Current User Profile Retrieve the profile of the connected user, including display name, country, product tier, follower count, and profile images. Useful as a connection check.
- Get User Top Items Retrieve the current user top artists or top tracks over a chosen time range. Requires the user-top-read scope.
Start building with Spotify
$100 in credits. No card required. Connect in minutes.