Spotify icon

Spotify

Control Spotify playback, manage playlists and library items, and read catalog metadata for the authenticated user.

1 trigger30 searches19 actionsPollingAuth: OAuth

AI-assisted documentation20 min read

This documentation is compiled from our integration source code, internal specs for Spotify, its official API documentation and anonymized requests logs we collect from our support team[2].

Open Spotify on WEXTL →

To use Spotify on WEXTL you need an active account and OAuth client credentials, granted by signing in with your account.[3]

You’ll be redirected to sign in and approve access — your password is never shared with WEXTL.

  • Client IDtextRequired

    Spotify Developer Dashboard → your app → Client ID.

    [1]
  • Client SecretpasswordRequired

    Client Secret for the same app. Reset in the dashboard if needed.

    [1]
Integration requests 16 permissions:
Read access to private playlists.Read access to collaborative playlists.Write access to public playlists.Write access to private playlists.Read access to saved library items.Write access to saved library items.Read access to profile details.Read access to email address.Read access to followed artists.Read access to top artists and tracks.Read access to playback state.Read access to playback position.Read access to recently played tracks.Read access to currently playing track.Write access to playback control.Upload custom playlist images.
  1. Log in to your WEXTL account, add the Spotify node module to your workflow, and click Create new credential.
  2. Optional: In the Credential name field, enter a name for the credential.
  3. Enter the authentication credentials you copied from your Spotify account, or follow the on-screen instructions to create the credential.
  4. If prompted, authenticate your account and confirm access.
  5. If you want to make changes to your credential in the future, follow the steps in Manage credentials →

Notes

Credentials are org-scoped; share them with teammates from the Credentials picker on any of its nodes.For detailed information on connecting an application, see Connect an application →

Watch Recently Played TracksTrigger
Input fields[3]
FieldType
Sincedate
Limitnumber
Output fields[3]
FieldType
Trackobject
Albumobject
Artistsarray
Disc Numbernumber
Duration Msnumber
Explicitboolean
External IDsobject
External URLsobject
Hreftext
IDtext
Is Playableboolean
Played Atdate
Contextobject
Typetext
Hreftext
External URLsobject
URItext
Check Library ContainsSearch
Input fields[3]
FieldType
URIsRequired
array
URItext
Output fields[3]
FieldType
Savedboolean
Get AlbumSearch
Input fields[3]
FieldType
IDRequired
text
Markettext
Output fields[3]
FieldType
Album Typetext
Total Tracksnumber
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Nametext
Release Datetext
Release Date Precisiontext
Restrictionsobject
Reasontext
Typetext
URItext
Artistsarray
External URLsobject
Hreftext
IDtext
Nametext
Typetext
URItext
Tracksobject
Hreftext
Limitnumber
Nexttext
Offsetnumber
Previoustext
Totalnumber
Itemsarray
Copyrightsarray
Texttext
Typetext
External IDsobject
UPCtext
EANtext
ISRCtext
Get ArtistSearch
Input fields[3]
FieldType
Artist IDRequired
text
Output fields[3]
FieldType
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Nametext
Typetext
URItext
Get AudiobookSearch
Input fields[3]
FieldType
IDRequired
text
Markettext
Output fields[3]
FieldType
Authorsarray
Nametext
Copyrightsarray
Texttext
Typetext
Descriptiontext
HTML Descriptiontext
Editiontext
Explicitboolean
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Languagesarray
Languagetext
Media Typetext
Nametext
Narratorsarray
Nametext
Typetext
URItext
Total Chaptersnumber
Chaptersobject
Hreftext
Limitnumber
Nexttext
Offsetnumber
Previoustext
Totalnumber
Itemsarray
Get ChapterSearch
Input fields[3]
FieldType
IDRequired
text
Markettext
Output fields[3]
FieldType
Chapter Numbernumber
Descriptiontext
HTML Descriptiontext
Duration Msnumber
Explicitboolean
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Is Playableboolean
Languagesarray
Languagetext
Nametext
Release Datetext
Release Date Precisiontext
Resume Pointobject
Fully Playedboolean
Resume Position Msnumber
Typetext
URItext
Restrictionsobject
Reasontext
Audiobookobject
Authorsarray
Copyrightsarray
Descriptiontext
HTML Descriptiontext
Editiontext
Explicitboolean
External URLsobject
Hreftext
IDtext
Imagesarray
Get Current User ProfileSearch
Output fields[3]
FieldType
Account IDtext
Display Nametext
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Typetext
URItext
Get Currently Playing TrackSearch
Input fields[3]
FieldType
Markettext
Output fields[3]
FieldType
Deviceobject
IDtext
Is Activeboolean
Is Private Sessionboolean
Is Restrictedboolean
Nametext
Typetext
Volume Percentnumber
Supports Volumeboolean
Repeat Statetext
Shuffle Stateboolean
Contextobject
Typetext
Hreftext
External URLsobject
URItext
Timestampnumber
Progress Msnumber
Is Playingboolean
Itemobject
Albumobject
Artistsarray
Disc Numbernumber
Duration Msnumber
Explicitboolean
External IDsobject
External URLsobject
Hreftext
IDtext
Is Playableboolean
Currently Playing Typetext
Actionsobject
Interrupting Playbackboolean
Pausingboolean
Resumingboolean
Seekingboolean
Skipping Nextboolean
Skipping Prevboolean
Toggling Repeat Contextboolean
Toggling Shuffleboolean
Toggling Repeat Trackboolean
Transferring Playbackboolean
Get EpisodeSearch
Input fields[3]
FieldType
IDRequired
text
Markettext
Output fields[3]
FieldType
Descriptiontext
HTML Descriptiontext
Duration Msnumber
Explicitboolean
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Is Externally Hostedboolean
Is Playableboolean
Languagesarray
Languagetext
Nametext
Release Datetext
Release Date Precisiontext
Resume Pointobject
Fully Playedboolean
Resume Position Msnumber
Typetext
URItext
Restrictionsobject
Reasontext
Showobject
Copyrightsarray
Descriptiontext
HTML Descriptiontext
Explicitboolean
External URLsobject
Hreftext
IDtext
Imagesarray
Is Externally Hostedboolean
Languagesarray
Get Playback QueueSearch
Input fields[3]
FieldType
Markettext
Output fields[3]
FieldType
Currently Playingobject
Albumobject
Artistsarray
Disc Numbernumber
Duration Msnumber
Explicitboolean
External IDsobject
External URLsobject
Hreftext
IDtext
Is Playableboolean
Queuearray
Albumobject
Artistsarray
Disc Numbernumber
Duration Msnumber
Explicitboolean
External IDsobject
External URLsobject
Hreftext
IDtext
Is Playableboolean
Get Playback StateSearch
Input fields[3]
FieldType
Markettext
Additional Typestext
Output fields[3]
FieldType
Deviceobject
IDtext
Is Activeboolean
Is Private Sessionboolean
Is Restrictedboolean
Nametext
Typetext
Volume Percentnumber
Supports Volumeboolean
Repeat Statetext
Shuffle Stateboolean
Contextobject
Typetext
Hreftext
External URLsobject
URItext
Timestampnumber
Progress Msnumber
Is Playingboolean
Itemobject
Albumobject
Artistsarray
Disc Numbernumber
Duration Msnumber
Explicitboolean
External IDsobject
External URLsobject
Hreftext
IDtext
Is Playableboolean
Currently Playing Typetext
Actionsobject
Interrupting Playbackboolean
Pausingboolean
Resumingboolean
Seekingboolean
Skipping Nextboolean
Skipping Prevboolean
Toggling Repeat Contextboolean
Toggling Shuffleboolean
Toggling Repeat Trackboolean
Transferring Playbackboolean
Get PlaylistSearch
Input fields[3]
FieldType
PlaylistRequired
choice
Markettext
Fieldstext
Output fields[3]
FieldType
Collaborativeboolean
Descriptiontext
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Nametext
Ownerobject
External URLsobject
Hreftext
IDtext
Typetext
URItext
Display Nametext
Publicboolean
Snapshot IDtext
Itemsobject
Hreftext
Limitnumber
Nexttext
Offsetnumber
Previoustext
Totalnumber
Itemsarray
Typetext
URItext
Get Playlist Cover ImageSearch
Input fields[3]
FieldType
PlaylistRequired
choice
Output fields[3]
FieldType
URLtext
Heightnumber
Widthnumber
Get ShowSearch
Input fields[3]
FieldType
IDRequired
text
Markettext
Output fields[3]
FieldType
Copyrightsarray
Texttext
Typetext
Descriptiontext
HTML Descriptiontext
Explicitboolean
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Is Externally Hostedboolean
Languagesarray
Languagetext
Media Typetext
Nametext
Typetext
URItext
Total Episodesnumber
Episodesobject
Hreftext
Limitnumber
Nexttext
Offsetnumber
Previoustext
Totalnumber
Itemsarray
Get TrackSearch
Input fields[3]
FieldType
IDRequired
text
Markettext
Output fields[3]
FieldType
Albumobject
Album Typetext
Total Tracksnumber
External URLsobject
Hreftext
IDtext
Imagesarray
Nametext
Release Datetext
Release Date Precisiontext
Restrictionsobject
Artistsarray
External URLsobject
Hreftext
IDtext
Nametext
Typetext
URItext
Disc Numbernumber
Duration Msnumber
Explicitboolean
External IDsobject
ISRCtext
EANtext
UPCtext
External URLsobject
Spotifytext
Hreftext
IDtext
Is Playableboolean
Restrictionsobject
Reasontext
Nametext
Track Numbernumber
Typetext
URItext
Is Localboolean
List Album TracksSearch
Input fields[3]
FieldType
Album IDRequired
text
LimitRequired
number
Output fields[3]
FieldType
Artistsarray
Disc Numbernumber
Duration Msnumber
Explicitboolean
External Urlsobject
Hreftext
IDtext
Is Playableboolean
Linked Fromobject
Restrictionsobject
Nametext
Preview Urltext
Track Numbernumber
Typetext
Uritext
Is Localboolean
List Artist AlbumsSearch
Input fields[3]
FieldType
Artist IDRequired
text
Include Groupstext
Markettext
LimitRequired
number
Output fields[3]
FieldType
Album Typetext
Total Tracksnumber
External Urlsobject
Hreftext
IDtext
Imagesarray
Nametext
Release Datetext
Release Date Precisiontext
Restrictionsobject
Typetext
Uritext
Artistsarray
Album Grouptext
List Audiobook ChaptersSearch
Input fields[3]
FieldType
IDRequired
text
LimitRequired
number
Output fields[3]
FieldType
Chapter Numbernumber
Descriptiontext
HTML Descriptiontext
Duration Msnumber
Explicitboolean
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Is Playableboolean
Languagesarray
Languagetext
Nametext
Release Datetext
Release Date Precisiontext
Resume Pointobject
Fully Playedboolean
Resume Position Msnumber
Typetext
URItext
Restrictionsobject
Reasontext
List Followed ArtistsSearch
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Nametext
Typetext
URItext
List My PlaylistsSearch
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
Collaborativeboolean
Descriptiontext
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Nametext
Ownerobject
External URLsobject
Hreftext
IDtext
Typetext
URItext
Display Nametext
Publicboolean
Snapshot IDtext
Itemsobject
Hreftext
Totalnumber
Typetext
URItext
List Playback DevicesSearch
Input fields[3]
FieldType
Limitnumber
Output fields[3]
FieldType
IDtext
Is Activeboolean
Is Private Sessionboolean
Is Restrictedboolean
Nametext
Typetext
Volume Percentnumber
Supports Volumeboolean
List Playlist ItemsSearch
Input fields[3]
FieldType
PlaylistRequired
choice
LimitRequired
number
Output fields[3]
FieldType
Added Atdate
Added Byobject
External URLsobject
Hreftext
IDtext
Typetext
URItext
Is Localboolean
Itemobject
Albumobject
Artistsarray
Disc Numbernumber
Duration Msnumber
Explicitboolean
External IDsobject
External URLsobject
Hreftext
IDtext
Is Playableboolean
List Recently Played TracksSearch
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
Trackobject
Albumobject
Artistsarray
Disc Numbernumber
Duration Msnumber
Explicitboolean
External IDsobject
External URLsobject
Hreftext
IDtext
Is Playableboolean
Played Atdate
Contextobject
Typetext
Hreftext
External URLsobject
URItext
List Saved AlbumsSearch
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
Added Atdate
Albumobject
Album Typetext
Total Tracksnumber
External URLsobject
Hreftext
IDtext
Imagesarray
Nametext
Release Datetext
Release Date Precisiontext
Restrictionsobject
List Saved AudiobooksSearch
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
Authorsarray
Nametext
Copyrightsarray
Texttext
Typetext
Descriptiontext
HTML Descriptiontext
Editiontext
Explicitboolean
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Languagesarray
Languagetext
Media Typetext
Nametext
Narratorsarray
Nametext
Typetext
URItext
Total Chaptersnumber
List Saved EpisodesSearch
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
Added Atdate
Episodeobject
Descriptiontext
HTML Descriptiontext
Duration Msnumber
Explicitboolean
External URLsobject
Hreftext
IDtext
Imagesarray
Is Externally Hostedboolean
Is Playableboolean
List Saved ShowsSearch
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
Added Atdate
Showobject
Copyrightsarray
Descriptiontext
HTML Descriptiontext
Explicitboolean
External URLsobject
Hreftext
IDtext
Imagesarray
Is Externally Hostedboolean
Languagesarray
List Saved TracksSearch
Input fields[3]
FieldType
LimitRequired
number
Output fields[3]
FieldType
Added Atdate
Trackobject
Albumobject
Artistsarray
Disc Numbernumber
Duration Msnumber
Explicitboolean
External IDsobject
External URLsobject
Hreftext
IDtext
Is Playableboolean
List Show EpisodesSearch
Input fields[3]
FieldType
IDRequired
text
LimitRequired
number
Output fields[3]
FieldType
Descriptiontext
HTML Descriptiontext
Duration Msnumber
Explicitboolean
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Is Externally Hostedboolean
Is Playableboolean
Languagesarray
Languagetext
Nametext
Release Datetext
Release Date Precisiontext
Resume Pointobject
Fully Playedboolean
Resume Position Msnumber
Typetext
URItext
Restrictionsobject
Reasontext
List Top ItemsSearch
Input fields[3]
FieldType
TypeRequired
choice
Time Rangechoice
LimitRequired
number
Output fields[3]
FieldType
Imagesarray
URLtext
Heightnumber
Widthnumber
Albumobject
Album Typetext
Total Tracksnumber
External URLsobject
Hreftext
IDtext
Imagesarray
Nametext
Release Datetext
Release Date Precisiontext
Restrictionsobject
Artistsarray
External URLsobject
Hreftext
IDtext
Nametext
Typetext
URItext
Disc Numbernumber
Duration Msnumber
Explicitboolean
External IDsobject
ISRCtext
EANtext
UPCtext
External URLsobject
Spotifytext
Hreftext
IDtext
Is Playableboolean
Restrictionsobject
Reasontext
Nametext
Track Numbernumber
Typetext
URItext
Is Localboolean
Search CatalogSearch
Input fields[3]
FieldType
QueryRequired
text
TypeRequired
text
LimitRequired
number
Output fields[3]
FieldType
Tracksobject
Hreftext
Limitnumber
Nexttext
Offsetnumber
Previoustext
Totalnumber
Itemsarray
Artistsobject
Hreftext
Limitnumber
Nexttext
Offsetnumber
Previoustext
Totalnumber
Itemsarray
Albumsobject
Hreftext
Limitnumber
Nexttext
Offsetnumber
Previoustext
Totalnumber
Itemsarray
Playlistsobject
Hreftext
Limitnumber
Nexttext
Offsetnumber
Previoustext
Totalnumber
Itemsarray
Showsobject
Hreftext
Limitnumber
Nexttext
Offsetnumber
Previoustext
Totalnumber
Itemsarray
Episodesobject
Hreftext
Limitnumber
Nexttext
Offsetnumber
Previoustext
Totalnumber
Itemsarray
Audiobooksobject
Hreftext
Limitnumber
Nexttext
Offsetnumber
Previoustext
Totalnumber
Itemsarray
Add Playlist ItemsAction
Input fields[3]
FieldType
PlaylistRequired
choice
URIsRequired
array
URItext
Positionnumber
Output fields[3]
FieldType
Snapshot IDtext
Add to Playback QueueAction
Input fields[3]
FieldType
Devicechoice
URIRequired
text
Create PlaylistAction
Input fields[3]
FieldType
NameRequired
text
Publicboolean
Descriptiontext
Output fields[3]
FieldType
Collaborativeboolean
Descriptiontext
External URLsobject
Spotifytext
Hreftext
IDtext
Imagesarray
URLtext
Heightnumber
Widthnumber
Nametext
Ownerobject
External URLsobject
Hreftext
IDtext
Typetext
URItext
Display Nametext
Publicboolean
Snapshot IDtext
Itemsobject
Hreftext
Limitnumber
Nexttext
Offsetnumber
Previoustext
Totalnumber
Itemsarray
Typetext
URItext
Make an API Calluniversal
Input fields[3]
FieldType
URLRequired
text
MethodRequired
choice
Headersarray
Headerobject
Query Stringarray
Parameterobject
Bodytext
Pause PlaybackAction
Input fields[3]
FieldType
Devicechoice
Remove from LibraryAction
Input fields[3]
FieldType
URIsRequired
array
URItext
Remove Playlist ItemsAction
Input fields[3]
FieldType
PlaylistRequired
choice
ItemsRequired
array
Output fields[3]
FieldType
Snapshot IDtext
Save to LibraryAction
Input fields[3]
FieldType
URIsRequired
array
URItext
Seek Playback PositionAction
Input fields[3]
FieldType
Position (ms)Required
number
Devicechoice
Set Playback VolumeAction
Input fields[3]
FieldType
Devicechoice
Volume PercentRequired
number
Set Repeat ModeAction
Input fields[3]
FieldType
Devicechoice
StateRequired
choice
Skip To Next TrackAction
Input fields[3]
FieldType
Devicechoice
Skip To Previous TrackAction
Input fields[3]
FieldType
Devicechoice
Start PlaybackAction
Input fields[3]
FieldType
Devicechoice
Context URItext
URIsarray
URItext
Offsetobject
URItext
Positionnumber
Position (ms)number
Toggle ShuffleAction
Input fields[3]
FieldType
Devicechoice
StateRequired
boolean
Transfer PlaybackAction
Input fields[3]
FieldType
Device IDsRequired
text
Playboolean
Update Playlist DetailsAction
Input fields[3]
FieldType
PlaylistRequired
choice
Nametext
Descriptiontext
Publicboolean
Update Playlist ItemsAction
Input fields[3]
FieldType
PlaylistRequired
choice
Range Startnumber
Insert Beforenumber
Range Lengthnumber
URIsarray
URItext
Snapshot IDtext
Output fields[3]
FieldType
Snapshot IDtext
Upload Playlist Cover ImageAction
Input fields[3]
FieldType
PlaylistRequired
choice
ImageRequired
file

Look for Spotify templates in the WEXTL template library.

Browse templates →
  1. WEXTL® Spotify Source Code connector implementation.
  2. Our users use cases and automations.
  3. Official API Documentation for Spotify.
  4. WEXTL® visual workflow builder data.

Last updated: Aug 28, 2026 21:57