> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Spotify connector

- Connector: `appmixer.spotify`
- Version: 1.0.0
- Components: 8 (0 triggers, 8 actions)

Spotify is a music streaming platform. Search the catalogue for tracks with a fuzzy match score that survives typos and hand-typed tracklists, create playlists, and add, replace or list their items.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.spotify/1.0.0>
- Documentation: <https://docs.appmixer.com/connector-configuration/spotify>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/spotify>
- Download package: <https://connectors.appmixer.com/connector/appmixer.spotify/1.0.0/download>

## Authentication

**Type:** OAuth 2

**Scopes:**

- `playlist-read-private`
- `playlist-modify-private`
- `playlist-modify-public`
- `user-library-modify`

## Actions (8)

- [Add Items To Playlist](https://connectors.appmixer.com/connector/appmixer.spotify/1.0.0/component/appmixer.spotify.core.AddItemsToPlaylist.md) (`appmixer.spotify.core.AddItemsToPlaylist`): Adds tracks to a Spotify playlist, in chunks of 100 so a whole tracklist fits in one message. Accepts an array from Find Tracks or a comma / newline separated list of URIs, IDs or links.
- [Create Playlist](https://connectors.appmixer.com/connector/appmixer.spotify/1.0.0/component/appmixer.spotify.core.CreatePlaylist.md) (`appmixer.spotify.core.CreatePlaylist`): Creates a new playlist for the connected Spotify account. The playlist is private unless you make it public.
- [Delete Playlist](https://connectors.appmixer.com/connector/appmixer.spotify/1.0.0/component/appmixer.spotify.core.DeletePlaylist.md) (`appmixer.spotify.core.DeletePlaylist`): Removes a playlist from the connected account's library. Spotify has no hard delete for playlists - this is what the Spotify clients themselves call "Delete".
- [Find Tracks](https://connectors.appmixer.com/connector/appmixer.spotify/1.0.0/component/appmixer.spotify.core.FindTracks.md) (`appmixer.spotify.core.FindTracks`): Search the Spotify catalogue for tracks and score how well each result matches the requested artist and title. Built for hand-typed tracklists: typos, "ft"/"+" collaborators and "/four tet rmx" version suffixes still match. Results below the minimum score leave through the Not Found port.
- [List Playlist Items](https://connectors.appmixer.com/connector/appmixer.spotify/1.0.0/component/appmixer.spotify.core.ListPlaylistItems.md) (`appmixer.spotify.core.ListPlaylistItems`): Lists the tracks of a Spotify playlist, following Spotify's pagination to the end. Each record carries the track plus the entry's own metadata (when and by whom it was added).
- [List Playlists](https://connectors.appmixer.com/connector/appmixer.spotify/1.0.0/component/appmixer.spotify.core.ListPlaylists.md) (`appmixer.spotify.core.ListPlaylists`): Lists the playlists of the connected Spotify account, following Spotify's pagination to the end. Also backs the Playlist dropdown on the other components.
- [Make API Call](https://connectors.appmixer.com/connector/appmixer.spotify/1.0.0/component/appmixer.spotify.core.MakeApiCall.md) (`appmixer.spotify.core.MakeApiCall`): Perform an arbitrary authorized API call to the Spotify Web API. Provide a path (or full URL), method, headers, query parameters and body. The Authorization header is added automatically.
- [Replace Playlist Items](https://connectors.appmixer.com/connector/appmixer.spotify/1.0.0/component/appmixer.spotify.core.ReplacePlaylistItems.md) (`appmixer.spotify.core.ReplacePlaylistItems`): Replaces the entire contents of a Spotify playlist with the given tracks - the way to keep a rolling "latest show" playlist. Leave the URIs empty to clear the playlist.

## Changelog

### 1.0.0

- Initial release.
