Spotify - Nango Docs

Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

✅ Authorization

Tools	Status
Pre-built authorization (OAuth)	✅
Credentials auto-refresh	✅
Auth parameters validation	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
Expired credentials detection	✅

✅ Read & write data

Tools	Status
Pre-built integrations	✅
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	🚫 (time to contribute: <48h)
Proxy requests	✅

✅ Observability & data quality

Tools	Status
HTTP request logging	✅
End-to-end type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

✅ Customization

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	🚫 (time to contribute: <48h)
Pre-configured rate-limit handling	🚫 (time to contribute: <48h)
Per-customer configurations	✅

Others

Function name	Description	Type	Source code
`add-to-queue`	Add a track or episode to the end of the user’s current playback queue.	Action	🔗 Github
`create-playlist-track`	Add one or more tracks to a Spotify playlist	Action	🔗 Github
`create-playlist`	Create a playlist in Spotify	Action	🔗 Github
`create-saved-album`	Save one or more albums to the current user’s library.	Action	🔗 Github
`create-saved-track`	Save one or more tracks to the current user’s library.	Action	🔗 Github
`delete-playlist-track`	Remove one or more tracks from a Spotify playlist	Action	🔗 Github
`delete-playlist`	Unfollow (remove) a playlist from the current user’s library	Action	🔗 Github
`delete-saved-album`	Remove one or more albums from the current user’s library.	Action	🔗 Github
`delete-saved-show`	Remove one or more shows (podcasts) from the current user’s library.	Action	🔗 Github
`delete-saved-track`	Remove one or more tracks from the current user’s library.	Action	🔗 Github
`follow-artist`	Follow one or more artists on behalf of the current user.	Action	🔗 Github
`follow-playlist`	Follow a playlist on behalf of the current user	Action	🔗 Github
`get-album`	Retrieve a single album from the Spotify catalog.	Action	🔗 Github
`get-artist`	Retrieve a single artist from the Spotify catalog.	Action	🔗 Github
`get-current-playback`	Fetch the user’s current playback state including device, track, and progress.	Action	🔗 Github
`get-current-user`	Fetch the current Spotify user profile	Action	🔗 Github
`get-devices`	List the user’s available Spotify Connect devices	Action	🔗 Github
`get-episode`	Retrieve a single podcast episode from the Spotify catalog.	Action	🔗 Github
`get-playlist`	Retrieve a single playlist from Spotify	Action	🔗 Github
`get-queue`	Retrieve the user’s current playback queue.	Action	🔗 Github
`get-show`	Retrieve a single show (podcast) from the Spotify catalog	Action	🔗 Github
`get-track`	Retrieve a single track from the Spotify catalog.	Action	🔗 Github
`list-albums`	List albums saved in the current user’s library.	Action	🔗 Github
`list-artists`	List artists followed by the current user	Action	🔗 Github
`list-playlist-tracks`	List tracks in a Spotify playlist.	Action	🔗 Github
`list-playlists`	List playlists owned or followed by the current user.	Action	🔗 Github
`list-saved-shows`	List shows (podcasts) saved in the current user’s library	Action	🔗 Github
`list-saved-tracks`	List tracks saved in the current user’s library.	Action	🔗 Github
`pause-playback`	Pause the user’s Spotify playback.	Action	🔗 Github
`reorder-playlist-tracks`	Reorder tracks within a Spotify playlist.	Action	🔗 Github
`search`	Search the Spotify catalog for tracks, albums, artists, playlists, shows, or episodes.	Action	🔗 Github
`seek-to-position`	Seek to a specific position in the currently playing track.	Action	🔗 Github
`set-repeat-mode`	Set the repeat mode for the user’s playback.	Action	🔗 Github
`set-volume`	Set the volume for the user’s current playback device.	Action	🔗 Github
`skip-to-next`	Skips to the next track in the user’s queue.	Action	🔗 Github
`skip-to-previous`	Skip to the previous track in the user’s queue	Action	🔗 Github
`start-playback`	Start or resume Spotify playback, optionally on a specific device or with a context	Action	🔗 Github
`toggle-shuffle`	Toggle shuffle mode on or off for the user’s playback	Action	🔗 Github
`transfer-playback`	Transfer playback to a different Spotify Connect device	Action	🔗 Github
`unfollow-playlist`	Unfollow a playlist on behalf of the current user	Action	🔗 Github
`update-playlist`	Update a playlist’s details (name, description, public/private status).	Action	🔗 Github
`albums`	Sync albums saved in the current user’s library	Sync	🔗 Github
`artists`	Sync artists followed by the current user.	Sync	🔗 Github
`playlist-tracks`	Sync tracks for a given playlist	Sync	🔗 Github
`playlists`	Sync playlists owned or followed by the current user	Sync	🔗 Github
`recently-played`	Sync recently played Spotify tracks	Sync	🔗 Github
`saved-episodes`	Sync podcast episodes saved in the current user’s library.	Sync	🔗 Github
`saved-shows`	Sync shows (podcasts) saved in the current user’s library	Sync	🔗 Github
`saved-tracks`	Sync tracks saved in the current user’s library	Sync	🔗 Github
`top-items`	Sync the user’s top artists and tracks across all time ranges.	Sync	🔗 Github

Access requirements

Pre-Requisites	Status	Comment
Paid dev account	❓
Paid test account	❓
Partnership	❓
App review	❓
Security audit	❓

Setup guide

No setup guide yet.

Need help getting started? Get help in the community.

Contribute improvements to the setup guide by editing this page

Useful links

Contribute useful links by editing this page

API gotchas

Spotify offers a client credentials token that authorizes as app instead of a user. This is listed under spotify-oauth2-cc. For more details check spotify client credentials flow
Contribute API gotchas by editing this page

​Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

​Pre-built tooling

​Others

​Access requirements

​Setup guide

​Useful links

​API gotchas

Overview

Pre-built tooling

Others

Access requirements

Setup guide

Useful links

API gotchas