New Device Added
Triggers when a new device is added.
Spotify is a digital music and podcast streaming service with millions of tracks, personalized playlists, and social sharing features
Triggers when a new device is added.
Triggers when a new playlist is created or deleted.
Triggers when songs are added to or removed from a Spotify playlist.
Add an item to the end of the user's current playback queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints. Required scope: user-modify-playback-state Note: Only tracks and episodes can be added to the queue. Albums and playlists cannot be added directly.
Add one or more items to a user's playlist.
Change a playlist's name and public/private state. The user must own the playlist. This action allows updating the playlist name, description, public/private status, and collaborative mode. At least one of the optional parameters (name, public, collaborative, description) must be provided. Important constraints: - collaborative can only be set to true on non-public playlists (when public is false) - Requires OAuth scope: playlist-modify-public (for public playlists) or playlist-modify-private (for private playlists) - The playlist must be owned by the authenticated user
Check whether the current user follows up to 50 specified artists or Spotify users. Results indicate follow status in the order of the supplied IDs; the user-follow-read scope is required. DEPRECATED: This endpoint is unavailable to affected Development Mode apps; use GET /me/library/contains with Spotify URIs instead.
Check whether the authenticated user follows a specified public or owned Spotify playlist. The result contains a boolean follow status; arbitrary users cannot be checked. DEPRECATED: This endpoint is unavailable to apps subject to updated Development Mode restrictions; use GET /me/library/contains with a Spotify URI instead.
Check whether up to 20 albums, identified by Spotify ID, are saved in the current user's library. Returns a boolean for each album in request order and requires user-library-read. DEPRECATED: This endpoint is unavailable under updated Development Mode restrictions; use GET /me/library/contains with Spotify URIs instead.
Check whether up to 50 audiobooks, identified by Spotify ID, are saved in the current user's library. Returns a boolean for each audiobook and requires user-library-read. DEPRECATED: The legacy endpoint is unavailable under updated Development Mode restrictions; use GET /me/library/contains with Spotify URIs instead. Extended Quota Mode apps are unaffected.
Check whether up to 50 podcast episodes by ID are saved in the current user's Your Episodes library. Returns boolean results in the order requested and requires user-library-read. DEPRECATED: The legacy endpoint is unavailable under updated Development Mode restrictions; use GET /me/library/contains with Spotify URIs instead. Extended Quota Mode apps are unaffected.
Check whether up to 50 shows, identified by Spotify ID, are saved in the current user's library. Returns a boolean for each show in request order and requires user-library-read. DEPRECATED: This endpoint is unavailable under updated Development Mode restrictions; use GET /me/library/contains with Spotify URIs instead.
Check whether up to 50 tracks, identified by Spotify track ID, are saved in the current user's library. Returns a boolean for each ID in request order and requires user-library-read. DEPRECATED: The legacy endpoint is unavailable to affected Development Mode apps; use GET /me/library/contains with Spotify URIs instead.
Create an empty playlist for a Spotify user, with a name and optional description, visibility, and collaboration settings. The appropriate playlist-modify permission is required. DEPRECATED: The user-specific endpoint is unavailable to affected Development Mode apps; use POST /me/playlists to create a playlist for the current user instead.
Follow one or more artists or Spotify users by ID for the current authenticated user, adding them to the user's following list. Requires user-follow-modify; up to 50 IDs can be supplied. DEPRECATED: The legacy endpoint is unavailable to affected Development Mode apps; Spotify recommends PUT /me/library with Spotify URIs instead.
Follow a playlist for the current Spotify user by playlist ID, publicly or privately. Requires playlist-modify-public or playlist-modify-private as appropriate. DEPRECATED: The legacy endpoint is unavailable under updated Development Mode restrictions; use PUT /me/library with a Spotify URI instead. Extended Quota Mode apps are unaffected.
Get Spotify catalog information for a single audiobook chapter including name, description, duration, release date, narrators, and playback information. Audiobook chapters are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets. Use this action to retrieve detailed metadata about a specific chapter when you have its Spotify ID.
Get Spotify catalog information for a single album by ID, including metadata, track listing, artist information and cover artwork. Popularity and available markets may be absent for Development Mode apps.
Get Spotify catalog information about an album's tracks. Optional parameters can be used to limit the number of tracks returned.
Get Spotify catalog information for a single audiobook. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.
Get detailed Spotify catalog information for a single artist, including name, genres, profile images and Spotify links. Follower count and popularity may be absent for Development Mode apps.
Get Spotify catalog information about an artist's albums.
Get Spotify catalog information about artists similar to a given artist. Similarity is based on analysis of the Spotify community's listening history.
Get Spotify catalog information about an artist's top tracks in a specified market, defaulting to the US. DEPRECATED: Spotify removed this endpoint for affected Development Mode apps and documents no replacement.
Get Spotify catalog information about an audiobook's chapters. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.
Get information about the user's available Spotify Connect devices. Returns a list of devices that can be used for playback, including their names, types (computer, smartphone, speaker), active status, volume levels, and whether they support API control. Useful for checking available playback targets before transferring playback or controlling volume. Requires the 'user-read-playback-state' scope. Note: Some device models are not supported and will not be listed in the API response.
Get available genre seeds for Spotify recommendations. Returns a list of genre strings that can be used as seed_genres parameter when requesting music recommendations. These genres represent the full set of available genre seeds on Spotify. No parameters are required for this endpoint. Note: This endpoint is deprecated but still functional as of the current API version.
Get the list of markets where Spotify is available, as ISO 3166-1 alpha-2 country codes. DEPRECATED: This endpoint is unavailable to affected Development Mode apps, and Spotify documents no replacement.
Get Spotify playlists tagged with a specific category (e.g., 'workout', 'party', 'dinner'). Returns a paginated list of playlists for the specified category. Use the limit and offset parameters to control pagination. Category IDs can be obtained from the Get Several Browse Categories endpoint. NOTE: This endpoint is deprecated as of November 2024 and may return 403 Forbidden for apps without extended quota access that was approved before November 27, 2024. Consider alternative endpoints for new implementations.
Get a paginated list of playlists owned or followed by the current Spotify user, with playlist metadata and pagination links. In updated Development Mode, track counts may be absent from the returned playlist objects.
Get profile information for the current authenticated Spotify user, including available display name, images and Spotify URIs. Email, country, subscription level, explicit content settings and follower count are unavailable under updated Development Mode restrictions.
Get the object currently being played on the user's Spotify account.
Get Spotify catalog information for a single podcast episode identified by its unique Spotify ID. This endpoint retrieves detailed information about a podcast episode including its name, description, duration, release date, cover art, show information, and playback status. It can also return the user's resume point if the user-read-playback-position scope is authorized. Episodes are podcast content on Spotify. Use this endpoint to get metadata and playback information for a specific episode when you have its Spotify ID.
Get a list of Spotify's editorially curated featured playlists. These are the playlists shown on a Spotify player's 'Browse' tab and are updated regularly by Spotify's editorial team. The response includes a localized message and a paginated list of simplified playlist objects.
Get a cursor-paginated list of artists followed by the current Spotify user using the after parameter; requires user-follow-read. Under updated Development Mode restrictions, follower counts and popularity are unavailable, and missing popularity is represented as zero.
Get a page of new album releases featured by Spotify, such as those shown in Browse. Use limit and offset to page through releases; the limit is 1–50 and defaults to 20. DEPRECATED: Spotify removed this endpoint for apps subject to updated Development Mode restrictions.
Get the current user's Spotify playback state, including the active device, current track or episode, progress, playback context, and repeat and shuffle settings. Requires user-read-playback-state. When no playback is active, the action returns a no-active-playback message.
Get metadata and available contents of a Spotify playlist, with optional field filtering. For affected Development Mode apps, playlist contents are returned only for playlists the user owns or collaborates on, and use the items field.
Get the current cover images associated with a playlist. The image array may be empty when no cover exists or when the API response is not an array; image URLs are temporary.
Get a paginated list of tracks or episodes in a playlist, with optional response field filtering. For affected Development Mode apps, playlist items are available only for playlists the user owns or collaborates on.
Get tracks from the current user's recently played tracks. _**Note**: Currently doesn't support podcast episodes._
Get track recommendations based on seed artists, genres, and/or tracks. At least one seed is required (up to 5 total). Optionally tune recommendations with audio feature parameters (acousticness, danceability, energy, etc.). IMPORTANT: This endpoint requires Spotify Extended API Access (restricted since Nov 27, 2024). Accounts without extended access will receive a 404 error. See: https://developer.spotify.com/blog/2024-11-27-changes-to-the-web-api Returns a list of recommended tracks with full track metadata including artists, album info, and audio features.
Get Spotify catalog information for up to 20 albums by Spotify ID, optionally specifying a market. DEPRECATED: The batch endpoint is unavailable to affected Development Mode apps; fetch albums individually using GET /albums/{id} instead.
Get Spotify catalog information for up to 50 artists in one request using their Spotify IDs. DEPRECATED: The batch endpoint is unavailable to affected Development Mode apps; retrieve artists individually using GET /artists/{id} instead.
Get Spotify catalog information for up to 50 audiobooks by ID in a single request, optionally specifying a market. Unavailable or nonexistent audiobooks appear as null in the results. DEPRECATED: The batch endpoint is unavailable to affected Development Mode apps; use GET /audiobooks/{id} for each audiobook instead.
List Spotify browse categories used to tag items, with locale and limit/offset pagination. DEPRECATED: The browse categories endpoint is unavailable to affected Development Mode apps; Spotify documents no replacement.
Get Spotify catalog details for up to 50 audiobook chapters by ID, including chapter metadata and parent audiobook information. This action is currently unavailable. DEPRECATED: The batch endpoint is unavailable under updated Development Mode restrictions; fetch chapters individually with GET /chapters/{id} instead. Extended Quota Mode apps are unaffected.
Get Spotify catalog information for up to 50 episodes by their IDs in a single request, with an optional market. DEPRECATED: The batch endpoint is unavailable to affected Development Mode apps; use GET /episodes/{id} for each episode instead.
Get Spotify catalog information for up to 50 shows by ID in a single request, optionally specifying a market. DEPRECATED: The batch endpoint is unavailable to affected Development Mode apps; use GET /shows/{id} for each show instead.
Get Spotify catalog information for multiple tracks by Spotify ID, with an optional market. DEPRECATED: The batch endpoint is unavailable to affected Development Mode apps; fetch tracks individually using GET /tracks/{id} instead.
Get audio features for multiple tracks based on their Spotify IDs. Returns audio feature information for multiple tracks including danceability, energy, loudness, speechiness, acousticness, instrumentalness, liveness, valence, tempo, and other musical attributes. Note: This endpoint was deprecated by Spotify on November 27, 2024. Applications created or approved after this date will receive 403 Forbidden errors. Only applications with existing extended mode Web API access that were relying on this endpoint before the cutoff date remain unaffected.
Get Spotify catalog information for a single show (podcast) identified by its unique Spotify ID.
Get Spotify catalog information about a show's episodes. Optional parameters can be used to limit the number of episodes returned. This endpoint retrieves a paginated list of episodes for a specific podcast/show.
Get information about a Spotify browse category by ID, including its name and icons, with an optional locale. DEPRECATED: This endpoint is unavailable to affected Development Mode apps; Spotify recommends removing features that use browse categories.
Get the list of tracks and episodes in the user's playback queue. Returns the currently playing track/episode and the queue of upcoming items. This is a read-only operation that does not modify the queue. Requirements: - Spotify Premium subscription required - Requires one of these OAuth scopes: - user-read-currently-playing - user-read-playback-state - An active Spotify session (user must be logged in on a device) Returns: - currently_playing: The track or episode currently playing (may be null) - queue: List of tracks/episodes queued for playback (may be empty) Common errors: - 403 Forbidden: Premium subscription required or insufficient OAuth scopes - 204 No Content: No active playback session
Get Spotify catalog information for a single track identified by its unique Spotify ID.
Get a comprehensive audio analysis for a Spotify track. Returns detailed structural and musical characteristics including: - Meta information (analyzer version, timestamp, processing time) - Track properties (tempo, key, mode, time signature, loudness, duration) - Temporal structure (bars, beats, sections, tatums) - Segments with pitch content and timbre characteristics All timing values are in seconds. Confidence scores range from 0.0 to 1.0. Useful for music analysis, visualization, and recommendation systems.
Get audio feature information for a single track identified by its unique Spotify ID. Note: This endpoint was deprecated by Spotify on November 27, 2024. Applications created or approved after this date will receive 403 Forbidden errors. Only applications with existing extended mode Web API access that were relying on this endpoint before the cutoff date remain unaffected.
Get a list of albums saved in the current Spotify user's library ('Your Music'). Returns a paginated list of albums that the user has saved to their library, including when each album was added and full album details (tracks, artists, images, etc.). Supports pagination via limit and offset parameters, and can filter by market availability. Required OAuth scope: user-library-read
Get a list of the audiobooks saved in the current Spotify user's 'Your Music' library.
Get a paginated list of playlists owned or followed by a specified Spotify user, using limit and offset. Access to private or collaborative playlists requires the appropriate authorization and scopes. DEPRECATED: This endpoint is unavailable to affected Development Mode apps; Spotify provides GET /me/playlists for the current user, but no replacement for other users' playlists.
Retrieve public profile information for a Spotify user by user ID, such as their display name and profile images. DEPRECATED: The specified-user profile endpoint is unavailable to affected Development Mode apps. Spotify provides GET /me for the current user's profile, but no replacement for another user's profile.
Get a list of episodes saved in the current Spotify user's library. This endpoint retrieves a paginated list of podcast episodes that the authenticated user has saved to their Spotify library. Each item in the response includes the full episode details and the timestamp when it was added to the library. **Required OAuth Scopes:** - user-library-read: Access your saved content - user-read-playback-position: Read your position in content you have played (for resume_point) **Note:** This endpoint is currently in beta and may change without warning. Please share feedback or issues in the Spotify developer community forum.
Get a list of shows saved in the current Spotify user's library. Optional parameters can be used to limit the number of shows returned.
Get a list of the songs saved in the current Spotify user's 'Your Music' library. Returns paginated results with track details including album info, artists, duration, and when each track was saved.
Get a paginated list of the current user's top artists based on listening affinity over a selected time range; requires user-top-read. Artist details may include genres, images, popularity, and follower counts.
Get the current user's top tracks based on listening affinity over a selected time range. Supports limit and offset pagination and requires the user-top-read scope. This action is currently unavailable.
Pause playback on the user's account. Pauses playback on the currently active device or on a specified device. Returns immediately with success when playback is paused. If no device is specified, the currently active device will be paused. Requirements: - Spotify Premium subscription - OAuth scope: user-modify-playback-state - Active playback session Note: The order of execution is not guaranteed when you use this API with other Player API endpoints. If playback is already paused, this action will still succeed (idempotent). Common scenarios: - Pause current playback: Call with no parameters - Pause specific device: Provide device_id parameter Error scenarios: - 403: User does not have Spotify Premium - 404: No active device found
Remove one or more items from a user's playlist. This endpoint removes tracks or episodes from a playlist. You can remove items by URI (removes all occurrences) or by URI + positions (removes specific occurrences). Requires 'playlist-modify-public' scope for public playlists or 'playlist-modify-private' scope for private playlists.
Remove one or more shows by Spotify ID from the current user's library. Requires the user-library-modify scope. DEPRECATED: This show-specific endpoint is unavailable to affected Development Mode apps; use DELETE /me/library with Spotify URIs instead.
Remove one or more tracks by Spotify ID from the current user's library. Requires the user-library-modify scope. DEPRECATED: The track-specific endpoint is unavailable to apps subject to updated Development Mode restrictions; use DELETE /me/library with Spotify URIs instead.
Remove one or more saved audiobooks from the current user's Spotify library by ID. Supply up to 50 IDs as a list or comma-separated string; user-library-modify is required. DEPRECATED: This legacy endpoint is unavailable to affected Development Mode apps; use DELETE /me/library with Spotify URIs instead.
Remove up to 50 episodes by ID from the current user's Your Episodes library; removing an unsaved episode succeeds. Requires user-library-modify. This action is currently unavailable. DEPRECATED: Spotify replaced the legacy endpoint with DELETE /me/library for affected Development Mode apps; Extended Quota Mode apps are unaffected.
Remove one or more albums from the current user's saved library. Removing an album that is not saved does not cause an error. Requires user-library-modify. DEPRECATED: The album-specific endpoint is unavailable to apps subject to updated Development Mode restrictions; use DELETE /me/library with Spotify URIs instead.
Save one or more albums by Spotify ID to the current user's library. Requires the user-library-modify scope; saving an already saved album is idempotent. DEPRECATED: This album-specific endpoint is unavailable to affected Development Mode apps; use PUT /me/library with Spotify URIs instead.
Save up to 50 audiobooks by Spotify ID to the current user's library for later access. Requires the user-library-modify scope. DEPRECATED: Spotify removed this audiobook-specific endpoint for apps subject to updated Development Mode restrictions; use PUT /me/library with Spotify URIs instead.
Save up to 50 podcast episodes by Spotify ID to the current user's Your Episodes library for later playback. Saving an already saved episode succeeds; the user-library-modify scope is required. DEPRECATED: This legacy endpoint is unavailable to affected Development Mode apps; use PUT /me/library with Spotify URIs instead. Extended Quota Mode apps retain the legacy endpoint.
Save up to 50 shows by Spotify ID to the current user's library. Requires the user-library-modify scope. DEPRECATED: This endpoint is unavailable to affected Development Mode apps; use PUT /me/library with Spotify URIs instead.
Save tracks to the current user's Spotify library using up to 50 track IDs or timestamped IDs. Requires user-library-modify. DEPRECATED: This legacy endpoint is unavailable to affected Development Mode apps; use PUT /me/library with Spotify URIs instead.
Search Spotify's catalog for albums, artists, playlists, tracks, shows, episodes or audiobooks matching a keyword. The default limit is 20; affected Development Mode apps must specify a limit of at most 10 and can paginate using offset. Audiobooks are available only in the US, UK, Canada, Ireland, New Zealand and Australia markets.
Seek to a position in milliseconds in the user's currently playing track, targeting a specified device or the active device by default. A position beyond the track duration skips to the next track. Requires Spotify Premium and the user-modify-playback-state scope; execution order with other Player API commands is not guaranteed.
Set the volume for the user's current playback device. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.
Set the repeat mode for the user's playback. Controls whether playback should repeat the current track, the current context (playlist, album, etc.), or not repeat at all. The change takes effect immediately on the user's active device. Requirements: - Spotify Premium subscription - OAuth scope: user-modify-playback-state - Active playback session Valid repeat modes: - "track": Repeat the current track continuously - "context": Repeat the current context (playlist/album/etc.) - "off": Turn repeat off Note: The order of execution is not guaranteed when you use this API with other Player API endpoints. This action is idempotent - setting the same repeat mode multiple times has the same effect as setting it once. Common scenarios: - Turn off repeat: {"state": "off"} - Repeat current track: {"state": "track"} - Repeat playlist/album: {"state": "context"} - Target specific device: {"state": "off", "device_id": "abc123"} Error scenarios: - 403: User does not have Spotify Premium - 404: No active device found
Skips to next track in the user's queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.
Skips to the previous track in the user's queue. Requirements: - Spotify Premium subscription - Active playback (user must be currently playing music) - Requires 'user-modify-playback-state' scope Note: The order of execution is not guaranteed when you use this API with other Player API endpoints.
Start playback of a context or list of tracks, or resume playback on a Spotify device. Requires Spotify Premium and the user-modify-playback-state scope; execution order relative to other Player API endpoints is not guaranteed.
Toggle shuffle on or off for user's playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints. Required OAuth scope: user-modify-playback-state Note: This endpoint returns 204 No Content on success, 404 if no active device is found, and 403 if the user does not have an active Spotify Premium subscription.
Transfer playback to a new device and optionally begin playback. Requires Spotify Premium and the user-modify-playback-state scope; execution order relative to other Player API endpoints is not guaranteed.
Unfollow up to 50 artists or Spotify users by ID for the current user, removing them from the following list. Requires user-follow-modify; unfollowing an already-unfollowed account succeeds. DEPRECATED: The legacy endpoint is unavailable under updated Development Mode restrictions; use DELETE /me/library with Spotify URIs instead. Extended Quota Mode apps are unaffected.
Unfollow a playlist by ID for the current user, removing it from their followed playlists. The operation succeeds if the user is not already following it and requires the appropriate playlist-modify scope. DEPRECATED: The legacy endpoint is unavailable to affected Development Mode apps; use DELETE /me/library with a Spotify URI instead.
Either replace all tracks in a playlist OR reorder existing tracks within it. **REPLACE mode**: Use `uris` parameter to completely overwrite all tracks in the playlist. Example: Replace all tracks with 3 specific tracks. **REORDER mode**: Use `range_start`, `insert_before`, and optionally `range_length`/`snapshot_id` to move tracks within the playlist without adding/removing any. Example: Move tracks at positions 5-7 to the beginning of the playlist. These two modes are mutually exclusive - you cannot use both in the same request.
The Spotify integration connects your Dench AI CRM directly to Spotify, so agents can read and act on your Spotify data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.
88 actions are available for agents to invoke on your behalf, and 3 triggers can start a Dench automation the moment something changes in Spotify. Every call runs through Spotify's own authorization, scoped to the account you connect.
Sign in to your Dench workspace and open Integrations.
Find Spotify and click Connect — you'll authorize access through Spotify's own sign-in flow. No API keys or code required.
Ask an agent to use Spotify in chat, or wire a Spotify trigger into an automation.
Manage or disconnect the connection any time from workspace settings.
The Dench Spotify integration connects your AI CRM to Spotify, so AI agents can work with your Spotify data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.
The Spotify integration currently exposes 88 actions, including Add item to playback queue, Add items to playlist, Change playlist details, Check if user follows artists or users, Check if users follow playlist, and Check user s saved albums. Agents invoke them on your behalf from chat or from automations.
Yes. The Spotify integration provides 3 triggers — such as New Device Added, New Playlist Created or Deleted, and Spotify Playlist Item Change — that can start a Dench automation the moment something happens in Spotify.
No. You connect Spotify from your Dench workspace using Spotify's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.
Connections are authorized through Spotify's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Spotify connection from your workspace settings at any time.