AACFlow

Spotify

Search music, manage playlists, control playback, and access your Spotify library.

Spotify

Spotify is the world's leading music streaming service. The AACFlow block connects to the Spotify Web API using OAuth 2.0 to automate music discovery, playlist management, library curation, and playback control.

Official API documentation: https://developer.spotify.com/documentation/web-api

Setup

  1. Go to the Spotify Developer Dashboard and create an application.
  2. Add https://app.aacflow.io/api/auth/callback/spotify as a Redirect URI (replace with your instance URL if self-hosted).
  3. Note the Client ID and Client Secret.
  4. In AACFlow, go to Settings → Integrations → Spotify and complete the OAuth connection. Grant the scopes required for the operations you plan to use (see the Spotify API scopes reference).

Operations

Search & Discovery

OperationDescription
spotify_searchSearch for tracks, albums, artists, playlists, shows, episodes, or audiobooks.
spotify_get_new_releasesBrowse new album releases.
spotify_get_categoriesList Spotify content categories.
spotify_get_marketsList available markets.

Tracks

OperationDescription
spotify_get_trackGet a track by Spotify ID.
spotify_get_tracksGet multiple tracks by IDs.
spotify_get_saved_tracksGet the current user's saved tracks.
spotify_save_tracksSave tracks to the current user's library.
spotify_remove_saved_tracksRemove saved tracks.
spotify_check_saved_tracksCheck whether tracks are saved.
spotify_get_recently_playedGet recently played tracks.

Albums

OperationDescription
spotify_get_albumGet an album by ID.
spotify_get_albumsGet multiple albums.
spotify_get_album_tracksGet tracks of an album.
spotify_get_saved_albumsGet saved albums.
spotify_save_albumsSave albums.
spotify_remove_saved_albumsRemove saved albums.
spotify_check_saved_albumsCheck whether albums are saved.

Artists

OperationDescription
spotify_get_artistGet an artist by ID.
spotify_get_artistsGet multiple artists.
spotify_get_artist_albumsGet albums by an artist.
spotify_get_artist_top_tracksGet an artist's top tracks.
spotify_follow_artistsFollow artists.
spotify_unfollow_artistsUnfollow artists.
spotify_get_followed_artistsGet followed artists.
spotify_check_followingCheck whether the user follows artists or users.

Playlists

OperationDescription
spotify_get_playlistGet a playlist by ID.
spotify_get_playlist_tracksGet tracks in a playlist.
spotify_get_playlist_coverGet a playlist's cover image.
spotify_get_user_playlistsGet the current user's playlists.
spotify_create_playlistCreate a new playlist.
spotify_update_playlistUpdate a playlist's name or description.
spotify_add_playlist_coverUpload a custom cover image (base64 JPEG).
spotify_add_tracks_to_playlistAdd tracks to a playlist.
spotify_remove_tracks_from_playlistRemove tracks from a playlist.
spotify_reorder_playlist_itemsReorder items in a playlist.
spotify_replace_playlist_itemsReplace all items in a playlist.
spotify_follow_playlistFollow a playlist.
spotify_unfollow_playlistUnfollow a playlist.
spotify_check_playlist_followersCheck whether users follow a playlist.

Podcasts (Shows)

OperationDescription
spotify_get_showGet a show (podcast) by ID.
spotify_get_showsGet multiple shows.
spotify_get_show_episodesGet episodes of a show.
spotify_get_saved_showsGet saved shows.
spotify_save_showsSave shows.
spotify_remove_saved_showsRemove saved shows.
spotify_check_saved_showsCheck whether shows are saved.

Episodes

OperationDescription
spotify_get_episodeGet an episode by ID.
spotify_get_episodesGet multiple episodes.
spotify_get_saved_episodesGet saved episodes.
spotify_save_episodesSave episodes.
spotify_remove_saved_episodesRemove saved episodes.
spotify_check_saved_episodesCheck whether episodes are saved.

Audiobooks

OperationDescription
spotify_get_audiobookGet an audiobook by ID.
spotify_get_audiobooksGet multiple audiobooks.
spotify_get_audiobook_chaptersGet chapters of an audiobook.
spotify_get_saved_audiobooksGet saved audiobooks.
spotify_save_audiobooksSave audiobooks.
spotify_remove_saved_audiobooksRemove saved audiobooks.
spotify_check_saved_audiobooksCheck whether audiobooks are saved.

User & Library

OperationDescription
spotify_get_current_userGet the current user's Spotify profile.
spotify_get_user_profileGet a public user's profile.
spotify_get_top_tracksGet the current user's top tracks.
spotify_get_top_artistsGet the current user's top artists.

Player Controls

OperationDescription
spotify_get_playback_stateGet the current playback state.
spotify_get_currently_playingGet the currently playing track.
spotify_get_devicesGet available playback devices.
spotify_get_queueGet the playback queue.
spotify_playStart or resume playback.
spotify_pausePause playback.
spotify_skip_nextSkip to the next track.
spotify_skip_previousSkip to the previous track.
spotify_seekSeek to a position in the current track.
spotify_add_to_queueAdd an item to the playback queue.
spotify_set_volumeSet the playback volume (0–100).
spotify_set_repeatSet the repeat mode (off / track / context).
spotify_set_shuffleEnable or disable shuffle.
spotify_transfer_playbackTransfer playback to a different device.

Example workflow

Search for tracks matching a mood keyword, create a new playlist for the day, add the top 20 results, then transfer playback to a specified device — all triggered by a morning schedule.

On this page

Start building today
Trusted by over 100,000 builders.
The SaaS platform to build AI agents and run your agentic workforce.
Get started