> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Spotify

> Spotify is a digital music and podcast streaming service with millions of tracks, personalized playlists, and social sharing features

![Spotify logo](https://mintcdn.com/composio-preview/B09iGux45A5cYDuO/images/toolkits/spotify.svg?fit=max\&auto=format\&n=B09iGux45A5cYDuO\&q=85\&s=18031ae898aac9ca72e65bc457a0fe3c)

* **Category:** news & lifestyle
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** No
* **Tools:** 88
* **Triggers:** 3
* **Slug:** `SPOTIFY`
* **Version:** 20261101\_00

## Frequently Asked Questions

> [accordion] Why is there no default OAuth app for Spotify?
>
> Composio does not provide a default OAuth app for Spotify. Create your own OAuth app in the [Spotify Developer Dashboard](https://developer.spotify.com/dashboard) to use the Spotify toolkit.

## Tools

> [accordion] Add items to playlist
>
> **Slug:** `SPOTIFY_ADD_ITEMS_TO_PLAYLIST`
>
> Add one or more items to a user's playlist.
>
> #### Input Parameters
>
> **uris** `string` *required*
>
> Spotify URIs of tracks or episodes to add. Accepts both URI types: - Track URI: 'spotify:track:4iV5W9uYEdYUVa79Axb7Rh' - Episode URI: 'spotify:episode:512ojhOuo1ktJprKbVcKyQ' Format options: - Comma-separated string: 'spotify:track:4iV5W9uYEdYUVa79Axb7Rh,spotify:track:1301WleyT98MSxVHPZCA6M' - List of strings: \['spotify:track:4iV5W9uYEdYUVa79Axb7Rh', 'spotify:track:1301WleyT98MSxVHPZCA6M'] Maximum 100 items per request. Items are added in the order specified.
>
> **position** `integer`
>
> Zero-based index for item insertion. Examples: - position=0: Insert at the beginning - position=2: Insert at the third position - Omitted (None): Append items to the end (default behavior)
>
> **playlist\_id** `string` *required*
>
> The Spotify ID of the playlist (e.g., '3cEYpjA9oz9GiPac4AsH4n'). Can be found in the playlist URL or obtained from playlist creation/search endpoints.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add item to playback queue
>
> **Slug:** `SPOTIFY_ADD_ITEM_TO_PLAYBACK_QUEUE`
>
> 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.
>
> #### Input Parameters
>
> **uri** `string` *required*
>
> The Spotify URI of the item to add to the queue. Must be a track or episode URI (e.g., 'spotify:track:4iV5W9uYEdYUVa79Axb7Rh' or 'spotify:episode:512ojhOuo1ktJprKbVcKyQ').
>
> **device\_id** `string`
>
> The ID of the device this command is targeting. If not supplied, the user's currently active device is the target.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Change playlist details
>
> **Slug:** `SPOTIFY_CHANGE_PLAYLIST_DETAILS`
>
> 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
>
> #### Input Parameters
>
> **name** `string`
>
> The new name for the playlist, for example "My New Playlist Title".
>
> **public** `boolean`
>
> If true the playlist will be public, if false it will be private.
>
> **description** `string`
>
> Value for playlist description as displayed in Spotify Clients and in the Web API.
>
> **playlist\_id** `string` *required*
>
> The Spotify ID of the playlist to update. Must be a playlist owned by the current user. Playlist IDs are 22-character base62 strings.
>
> **collaborative** `boolean`
>
> If true, the playlist will become collaborative and other users will be able to modify the playlist in their Spotify client. Note: You can only set collaborative to true on non-public playlists.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check if user follows artists or users
>
> **Slug:** `SPOTIFY_CHECK_IF_USER_FOLLOWS_ARTISTS_OR_USERS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of the artist or user Spotify IDs to check. Maximum of 50 IDs per request. Example: '2CIMQHirSU0MQqyYHq0eOx,57dN52uHvrHOxijzpIgu3E'
>
> **type** `string ("artist" | "user")` *required*
>
> The ID type: either 'artist' or 'user'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check if users follow playlist
>
> **Slug:** `SPOTIFY_CHECK_IF_USERS_FOLLOW_PLAYLIST`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> The Spotify user ID to check if they follow the playlist. Must be the current authenticated user's ID. Single user ID only (e.g., 'jmperezperez'). Note: While the API parameter is named 'ids', only the authenticated user can be checked.
>
> **playlist\_id** `string` *required*
>
> The Spotify ID of the playlist to check followers for. A 22-character alphanumeric string (e.g., '3cEYpjA9oz9GiPac4AsH4n').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check user s saved albums
>
> **Slug:** `SPOTIFY_CHECK_USER_S_SAVED_ALBUMS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify album IDs. Maximum: 20 IDs. Example: '382ObEPsp2rxGrnsizN5TX,1A2GTWGtFfWp7KSQTwWOyo'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check user s saved audiobooks
>
> **Slug:** `SPOTIFY_CHECK_USER_S_SAVED_AUDIOBOOKS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify audiobook IDs to check. Maximum 50 IDs. Example: '18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check User's Saved Episodes
>
> **Slug:** `SPOTIFY_CHECK_USER_S_SAVED_EPISODES`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify episode IDs to check (e.g., '77o6BIVlYM3msb4MMIL1jH,0Q86acNRm6V9GYx55SXKwf'). Maximum: 50 IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check user's saved shows
>
> **Slug:** `SPOTIFY_CHECK_USER_S_SAVED_SHOWS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of the Spotify IDs for the shows. Maximum: 50 IDs. Example: '5CfCWKI5pZ28U0uOzXkDHe,5as3aKmN2k11yfDDDSrvaZ'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check User's Saved Tracks
>
> **Slug:** `SPOTIFY_CHECK_USER_S_SAVED_TRACKS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify track IDs to check. Maximum of 50 IDs per request. Example: '7ouMYWpwJ422jRcDASZB7P,4VqPOruhp5EdPBeR92t6lQ'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create playlist
>
> **Slug:** `SPOTIFY_CREATE_PLAYLIST`
>
> 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.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name for the new playlist, for example `"Your Coolest Playlist"`. This name does not need to be unique; a user may have several playlists with the same name.
>
> **public** `boolean`
>
> Defaults to `true`. If `true` the playlist will be public, if `false` it will be private. To be able to create private playlists, the user must have granted the `playlist-modify-private` scope
>
> **user\_id** `string` *required*
>
> The Spotify user ID for whom to create the playlist. This can be obtained from the user's profile (e.g., using get\_current\_user\_s\_profile action).
>
> **description** `string`
>
> The playlist description as displayed in Spotify Clients and in the Web API. Optional field for providing additional context about the playlist.
>
> **collaborative** `boolean`
>
> Defaults to `false`. If `true` the playlist will be collaborative. ***Note***\*: to create a collaborative playlist you must also set `public` to `false`. To create collaborative playlists you must have granted `playlist-modify-private` and `playlist-modify-public` scopes.\*
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Follow artists or users
>
> **Slug:** `SPOTIFY_FOLLOW_ARTISTS_OR_USERS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify IDs for the artists or users to follow. Each ID is a 22-character alphanumeric string (e.g., '3WrFJ7ztbogyGnTHbHJFl2' for The Beatles). You can specify multiple IDs separated by commas (e.g., '3WrFJ7ztbogyGnTHbHJFl2,1dfeR4HaWDbWqFHLkxsg1d'). Maximum 50 IDs per request. Obtain artist IDs from search results or artist/track objects.
>
> **type** `string ("artist" | "user")` *required*
>
> The type of Spotify entity to follow. Use 'artist' to follow musical artists/bands, or 'user' to follow other Spotify users.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Follow playlist
>
> **Slug:** `SPOTIFY_FOLLOW_PLAYLIST`
>
> 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.
>
> #### Input Parameters
>
> **public** `boolean`
>
> Defaults to `true`. If `true` the playlist will be included in user's public playlists, if `false` it will remain private.
>
> **playlist\_id** `string` *required*
>
> The Spotify ID of the playlist to follow. This is a 22-character base62 string that uniquely identifies the playlist (e.g., '37i9dQZF1DXcBWIGoYBM5M').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a chapter
>
> **Slug:** `SPOTIFY_GET_A_CHAPTER`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID for the chapter. Chapter IDs are 22-character base62 strings (e.g., '0D5wENdkdwbqlrHoaJ9g29'). You can obtain chapter IDs from the get audiobook chapters endpoint or from Spotify URLs/URIs.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'CA'). Chapters are only available in US, UK, CA, IE, NZ, and AU markets. If specified, only content available in that market is returned. If not specified, the user's account market is used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Album Details
>
> **Slug:** `SPOTIFY_GET_ALBUM`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID of the album. Album IDs are 22-character base62 strings (e.g., '4aawyAB9vmqN3uQ7FjRGTy' for a valid album). You can obtain album IDs from search results, new releases, or artist album listings.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'DE'). If specified, only content available in that market is returned. Useful for checking regional availability.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get album tracks
>
> **Slug:** `SPOTIFY_GET_ALBUM_TRACKS`
>
> Get Spotify catalog information about an album's tracks. Optional parameters can be used to limit the number of tracks returned.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID of the album. This must be an album ID, not a track, artist, or playlist ID. Album IDs are 22-character base62 strings (e.g., '0ETFjACtuP2ADo6LFhL6HN'). You can obtain album IDs from the search endpoint or from album objects returned by other endpoints.
>
> **limit** `integer`
>
> The maximum number of tracks to return. Default: 20. Minimum: 1. Maximum: 50.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'CA'). If specified, only content available in that market is returned. If a valid user access token is provided, the country associated with the user account takes priority over this parameter. If not specified, tracks available in all markets are returned.
>
> **offset** `integer`
>
> The index of the first track to return. Default: 0 (the first track). Use with limit to paginate through tracks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get an audiobook
>
> **Slug:** `SPOTIFY_GET_AN_AUDIOBOOK`
>
> Get Spotify catalog information for a single audiobook. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID for the audiobook. Audiobook IDs are 22-character base62 strings (e.g., '7iHfbu1YPACw6oZPAFJtqe'). You can obtain audiobook IDs from the search endpoint or from Spotify URLs/URIs.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code. Audiobooks are only available in US, UK, CA, IE, NZ, and AU markets. If specified, only content available in that market is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get artist
>
> **Slug:** `SPOTIFY_GET_ARTIST`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID of the artist. Artist IDs are 22-character base62 strings (e.g., '0OdUWJ0sBjDrqHygGUXeCF'). You can obtain artist IDs from the search endpoint, track objects, album objects, or from Spotify URLs/URIs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get artist s albums
>
> **Slug:** `SPOTIFY_GET_ARTIST_S_ALBUMS`
>
> Get Spotify catalog information about an artist's albums.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID of the artist. This must be an artist ID, not a track, album, or playlist ID. Artist IDs are 22-character base62 strings (e.g., '0OdUWJ0sBjDrqHygGUXeCF'). You can obtain artist IDs from the search endpoint or from artist objects returned by other endpoints.
>
> **limit** `integer`
>
> The maximum number of albums to return. Default: 20. Minimum: 1. Maximum: 50.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code. If specified, only albums available in that market are returned. Example: 'US', 'GB', 'DE'.
>
> **offset** `integer`
>
> The index of the first album to return. Default: 0 (the first album). Use with limit to paginate through albums.
>
> **include\_groups** `string`
>
> A comma-separated list of keywords that will be used to filter the response. Valid values are: album, single, appears\_on, compilation. For example: 'album,single'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get artist s related artists
>
> **Slug:** `SPOTIFY_GET_ARTIST_S_RELATED_ARTISTS`
>
> Get Spotify catalog information about artists similar to a given artist. Similarity is based on analysis of the Spotify community's listening history.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID of the artist. Artist IDs are 22-character base62 strings (e.g., '0OdUWJ0sBjDrqHygGUXeCF'). You can obtain artist IDs from the search endpoint, track objects, album objects, or from Spotify URLs/URIs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Artist's Top Tracks
>
> **Slug:** `SPOTIFY_GET_ARTIST_S_TOP_TRACKS`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID of the artist (e.g., '06HL4z0CvFAxyc27GXpf02'). You can obtain artist IDs from search results or artist endpoints.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'JP') specifying which market's top tracks to retrieve. Different markets may return different top tracks based on regional popularity. Defaults to 'US' if not specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get audiobook chapters
>
> **Slug:** `SPOTIFY_GET_AUDIOBOOK_CHAPTERS`
>
> Get Spotify catalog information about an audiobook's chapters. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID for the audiobook. Audiobook IDs are 22-character base62 strings (e.g., '7iHfbu1YPACw6oZPAFJtqe'). You can obtain audiobook IDs from the search endpoint or from Spotify URLs/URIs.
>
> **limit** `integer`
>
> The maximum number of chapters to return. Default: 20. Minimum: 1. Maximum: 50.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code. Audiobooks are only available in US, UK, CA, IE, NZ, and AU markets. If specified, only chapters available in that market are returned.
>
> **offset** `integer`
>
> The index of the first chapter to return. Default: 0 (the first chapter). Use with limit to paginate through chapters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Available Devices
>
> **Slug:** `SPOTIFY_GET_AVAILABLE_DEVICES`
>
> 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.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get available genre seeds
>
> **Slug:** `SPOTIFY_GET_AVAILABLE_GENRE_SEEDS`
>
> 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.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get available markets
>
> **Slug:** `SPOTIFY_GET_AVAILABLE_MARKETS`
>
> 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.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Category's Playlists
>
> **Slug:** `SPOTIFY_GET_CATEGORY_S_PLAYLISTS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of playlists to return (0-50, default: 20).
>
> **offset** `integer`
>
> The index of the first playlist to return for pagination (default: 0, use with limit for paging).
>
> **category\_id** `string` *required*
>
> The Spotify category ID (e.g., 'toplists', 'pop', 'workout', 'party', 'dinner'). Get valid IDs from the Get Several Browse Categories endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get currently playing track
>
> **Slug:** `SPOTIFY_GET_CURRENTLY_PLAYING_TRACK`
>
> Get the object currently being played on the user's Spotify account.
>
> #### Input Parameters
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB'). If provided, only content available in that market will be returned. If a valid user access token is provided, the user's country takes priority.
>
> **additional\_types** `string`
>
> A comma-separated list of item types your client supports. Valid values are 'track' and 'episode'. Use 'track,episode' to support both tracks and podcast episodes. If not provided, only tracks are returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get current user s playlists
>
> **Slug:** `SPOTIFY_GET_CURRENT_USER_S_PLAYLISTS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The maximum number of playlists to return. Valid range: 1-50. Default: 20.
>
> **offset** `integer`
>
> The index of the first playlist to return (for pagination). Use with limit to retrieve playlists in batches. Valid range: 0-100,000. Default: 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get current user s profile
>
> **Slug:** `SPOTIFY_GET_CURRENT_USER_S_PROFILE`
>
> 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.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get episode
>
> **Slug:** `SPOTIFY_GET_EPISODE`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID for the episode (22-character alphanumeric string). Example: '512ojhOuo1ktJprKbVcKyQ'
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'ES'). If provided, only content available in that market will be returned. If a valid user access token is specified in the request header, the user's country takes priority.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get featured playlists
>
> **Slug:** `SPOTIFY_GET_FEATURED_PLAYLISTS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of featured playlists to return. Valid range: 1-50. Default: 20.
>
> **locale** `string`
>
> The desired language, consisting of an ISO 639-1 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore. Example: 'es\_MX' for Spanish (Mexico), 'sv\_SE' for Swedish (Sweden), 'en\_US' for English (United States). If not supplied or if the specified locale is not available, defaults to American English.
>
> **offset** `integer`
>
> The index of the first item to return for pagination (default: 0, use with limit).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get followed artists
>
> **Slug:** `SPOTIFY_GET_FOLLOWED_ARTISTS`
>
> 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.
>
> #### Input Parameters
>
> **type** `string ("artist")` *required*
>
> The ID type for the follow operation. Currently only 'artist' is supported by the Spotify API.
>
> **after** `string`
>
> The cursor for pagination. Provide the last artist ID from the previous response to retrieve the next page of results.
>
> **limit** `integer`
>
> Maximum number of items to return per request. Range: 0-50. Default: 20.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get new releases
>
> **Slug:** `SPOTIFY_GET_NEW_RELEASES`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of items to return. Must be between 1 and 50 (default: 20).
>
> **offset** `integer`
>
> The index of the first item to return. Use with limit for pagination (default: 0, must be >= 0).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get playback state
>
> **Slug:** `SPOTIFY_GET_PLAYBACK_STATE`
>
> 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.
>
> #### Input Parameters
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'JP'). If provided, only content available in that market will be returned. If not specified, content is based on the user's account country.
>
> **additional\_types** `string`
>
> Comma-separated list of item types to return beyond the default 'track'. Valid values: 'track', 'episode'. Example: 'track,episode' to include both tracks and episodes in the response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get playlist
>
> **Slug:** `SPOTIFY_GET_PLAYLIST`
>
> 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.
>
> #### Input Parameters
>
> **fields** `string`
>
> Filters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned. For example, to get just the playlist's name and tracks: 'name,tracks'. Useful for reducing response size and improving performance.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB'). If provided, only content available in that market will be returned. If a user's access token is used, the user's country takes priority.
>
> **playlist\_id** `string` *required*
>
> The Spotify ID of the playlist (e.g., '3cEYpjA9oz9GiPac4AsH4n')
>
> **additional\_types** `string`
>
> A comma-separated list of item types to return in the playlist's tracks. Supported values: 'track', 'episode'. By default, only 'track' items are returned. To include both tracks and podcast episodes, use 'track,episode'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get playlist cover image
>
> **Slug:** `SPOTIFY_GET_PLAYLIST_COVER_IMAGE`
>
> 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.
>
> #### Input Parameters
>
> **playlist\_id** `string` *required*
>
> The Spotify ID of the playlist (e.g., '3cEYpjA9oz9GiPac4AsH4n').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get playlist items
>
> **Slug:** `SPOTIFY_GET_PLAYLIST_ITEMS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
>
> **fields** `string`
>
> Comma-separated list of fields to return, using dot notation for nested fields. Reduces response size by returning only specified fields (e.g., 'items(track(name,id))' returns only track names and IDs).
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'CA'). If specified, only items available in that market are returned.
>
> **offset** `integer`
>
> The index of the first item to return. Default: 0 (the first item).
>
> **playlist\_id** `string` *required*
>
> The Spotify ID of the playlist. This is a 22-character base62 string (e.g., '37i9dQZF1DXcBWIGoYBM5M' for Today's Top Hits).
>
> **additional\_types** `string`
>
> Comma-separated list of item types to include beyond tracks. Valid values: 'track', 'episode'. Use 'track,episode' to retrieve both podcast episodes and music tracks from the playlist. Default behavior (None) returns only tracks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get recently played tracks
>
> **Slug:** `SPOTIFY_GET_RECENTLY_PLAYED_TRACKS`
>
> Get tracks from the current user's recently played tracks. ***Note***\*: Currently doesn't support podcast episodes.\*
>
> #### Input Parameters
>
> **after** `integer`
>
> A Unix timestamp in milliseconds. Returns all items after (but not including) this cursor position. If 'after' is specified, 'before' must not be specified.
>
> **limit** `integer`
>
> The maximum number of items to return. Minimum: 1. Maximum: 50. Default: 20.
>
> **before** `integer`
>
> A Unix timestamp in milliseconds. Returns all items before (but not including) this cursor position. If 'before' is specified, 'after' must not be specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get recommendations
>
> **Slug:** `SPOTIFY_GET_RECOMMENDATIONS`
>
> 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](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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of tracks to return (1-100, default: 20)
>
> **market** `string`
>
> ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB'). Filters results to those available in the specified market
>
> **max\_key** `integer`
>
> Maximum musical key (0-11, using Pitch Class notation: 0=C, 1=C#, 2=D, etc.)
>
> **min\_key** `integer`
>
> Minimum musical key (0-11, using Pitch Class notation: 0=C, 1=C#, 2=D, etc.)
>
> **max\_mode** `integer`
>
> Maximum modality (0=minor, 1=major)
>
> **min\_mode** `integer`
>
> Minimum modality (0=minor, 1=major)
>
> **max\_tempo** `number`
>
> Maximum tempo in beats per minute (BPM, e.g., 60 for slow, 120 for moderate, 180 for fast)
>
> **min\_tempo** `number`
>
> Minimum tempo in beats per minute (BPM, e.g., 60 for slow, 120 for moderate, 180 for fast)
>
> **max\_energy** `number`
>
> Maximum energy value (0.0 to 1.0). Higher values indicate more energetic, fast, loud tracks
>
> **min\_energy** `number`
>
> Minimum energy value (0.0 to 1.0). Higher values indicate more energetic, fast, loud tracks
>
> **target\_key** `integer`
>
> Target musical key (0-11, using Pitch Class notation: 0=C, 1=C#, 2=D, etc.)
>
> **max\_valence** `number`
>
> Maximum valence value (0.0 to 1.0). Higher values indicate more positive, cheerful tracks
>
> **min\_valence** `number`
>
> Minimum valence value (0.0 to 1.0). Higher values indicate more positive, cheerful tracks
>
> **seed\_genres** `string`
>
> Comma-separated list of genre names to use as seeds (e.g., 'pop,rock,indie'). Use get\_available\_genre\_seeds action to see available genres. Up to 5 total seeds across all seed types
>
> **seed\_tracks** `string`
>
> Comma-separated list of Spotify track IDs to use as seeds (e.g., '0c6xIDDpzE81m2q797ordA,3n3Ppam7vgaVa1iaRUc9Lp'). Up to 5 total seeds across all seed types
>
> **target\_mode** `integer`
>
> Target modality (0=minor, 1=major)
>
> **max\_liveness** `number`
>
> Maximum liveness value (0.0 to 1.0). Higher values indicate tracks likely recorded live with audience
>
> **max\_loudness** `number`
>
> Maximum loudness in decibels (typically -60 to 0). Higher values indicate louder tracks
>
> **min\_liveness** `number`
>
> Minimum liveness value (0.0 to 1.0). Higher values indicate tracks likely recorded live with audience
>
> **min\_loudness** `number`
>
> Minimum loudness in decibels (typically -60 to 0). Higher values indicate louder tracks
>
> **seed\_artists** `string`
>
> Comma-separated list of Spotify artist IDs to use as seeds (e.g., '4NHQUGzhtTLFvgF5SZesLK,06HL4z0CvFAxyc27GXpf02'). Up to 5 total seeds across all seed types
>
> **target\_tempo** `number`
>
> Target tempo in beats per minute (BPM). Recommendations will aim for this tempo
>
> **target\_energy** `number`
>
> Target energy value (0.0 to 1.0). Recommendations will aim for this energy level
>
> **max\_popularity** `integer`
>
> Maximum popularity (0-100). Higher values indicate more popular tracks
>
> **min\_popularity** `integer`
>
> Minimum popularity (0-100). Higher values indicate more popular tracks
>
> **target\_valence** `number`
>
> Target valence value (0.0 to 1.0). Recommendations will aim for this valence level
>
> **max\_duration\_ms** `integer`
>
> Maximum track duration in milliseconds (e.g., 300000 for 5 minutes)
>
> **max\_speechiness** `number`
>
> Maximum speechiness value (0.0 to 1.0). Higher values indicate tracks with more spoken words
>
> **min\_duration\_ms** `integer`
>
> Minimum track duration in milliseconds (e.g., 180000 for 3 minutes)
>
> **min\_speechiness** `number`
>
> Minimum speechiness value (0.0 to 1.0). Higher values indicate tracks with more spoken words
>
> **target\_liveness** `number`
>
> Target liveness value (0.0 to 1.0). Recommendations will aim for this liveness level
>
> **target\_loudness** `number`
>
> Target loudness in decibels. Recommendations will aim for this loudness level
>
> **max\_acousticness** `number`
>
> Maximum acousticness value (0.0 to 1.0). Higher values indicate more acoustic content
>
> **max\_danceability** `number`
>
> Maximum danceability value (0.0 to 1.0). Higher values indicate tracks more suitable for dancing
>
> **min\_acousticness** `number`
>
> Minimum acousticness value (0.0 to 1.0). Higher values indicate more acoustic content
>
> **min\_danceability** `number`
>
> Minimum danceability value (0.0 to 1.0). Higher values indicate tracks more suitable for dancing
>
> **target\_popularity** `integer`
>
> Target popularity (0-100). Recommendations will aim for this popularity level
>
> **max\_time\_signature** `integer`
>
> Maximum time signature (number of beats per measure, typically 3-7)
>
> **min\_time\_signature** `integer`
>
> Minimum time signature (number of beats per measure, typically 3-7)
>
> **target\_duration\_ms** `integer`
>
> Target track duration in milliseconds. Recommendations will aim for this duration
>
> **target\_speechiness** `number`
>
> Target speechiness value (0.0 to 1.0). Recommendations will aim for this speechiness level
>
> **target\_acousticness** `number`
>
> Target acousticness value (0.0 to 1.0). Recommendations will aim for this acousticness level
>
> **target\_danceability** `number`
>
> Target danceability value (0.0 to 1.0). Recommendations will aim for this danceability level
>
> **max\_instrumentalness** `number`
>
> Maximum instrumentalness value (0.0 to 1.0). Higher values indicate tracks with no vocals
>
> **min\_instrumentalness** `number`
>
> Minimum instrumentalness value (0.0 to 1.0). Higher values indicate tracks with no vocals
>
> **target\_time\_signature** `integer`
>
> Target time signature (number of beats per measure). Recommendations will aim for this time signature
>
> **target\_instrumentalness** `number`
>
> Target instrumentalness value (0.0 to 1.0). Recommendations will aim for this instrumentalness level
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get several albums
>
> **Slug:** `SPOTIFY_GET_SEVERAL_ALBUMS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify album IDs. Maximum 20 IDs allowed. Example: '382ObEPsp2rxGrnsizN5TX,1A2GTWGtFfWp7KSQTwWOyo'
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'DE'). If provided, only content available in that market will be returned. If not provided, content availability is based on the user's account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get several artists
>
> **Slug:** `SPOTIFY_GET_SEVERAL_ARTISTS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify artist IDs (e.g., '2CIMQHirSU0MQqyYHq0eOx,57dN52uHvrHOxijzpIgu3E'). Maximum: 50 IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get several audiobooks
>
> **Slug:** `SPOTIFY_GET_SEVERAL_AUDIOBOOKS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify IDs for the audiobooks. Maximum: 50 IDs. Audiobook IDs are 22-character base62 strings (e.g., '18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ').
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code. Audiobooks are only available in US, UK, CA, IE, NZ, and AU markets. If specified, only content available in that market is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get several browse categories
>
> **Slug:** `SPOTIFY_GET_SEVERAL_BROWSE_CATEGORIES`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of categories to return (1-50, default: 20).
>
> **locale** `string`
>
> Locale for the categories (e.g., 'en\_US', 'es\_ES').
>
> **offset** `integer`
>
> The index of the first category to return (default: 0).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get several chapters
>
> **Slug:** `SPOTIFY_GET_SEVERAL_CHAPTERS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify chapter IDs (e.g., '0D5wENdkdwbqlrHoaJ9g29,3ZXb8FKZGU0EHALYX6uCzU'). Chapter IDs are 22-character base62 strings. Maximum: 50 IDs. You can obtain chapter IDs from the get audiobook chapters endpoint or from Spotify URLs/URIs.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'CA'). Chapters are only available in US, UK, CA, IE, NZ, and AU markets. If specified, only content available in that market is returned. If not specified, the user's account market is used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get several episodes
>
> **Slug:** `SPOTIFY_GET_SEVERAL_EPISODES`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of the Spotify IDs for the episodes. Maximum: 50 IDs. Episode IDs are 22-character base62 strings (e.g., '77o6BIVlYM3msb4MMIL1jH,0Q86acNRm6V9GYx55SXKwf'). You can obtain episode IDs from the search endpoint, show episodes endpoint, or user's saved episodes endpoint.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'DE'). If specified, only episodes available in that market are returned. If a valid user access token is provided, the user's account country takes precedence. If neither market nor user country are specified, content is considered unavailable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get several shows
>
> **Slug:** `SPOTIFY_GET_SEVERAL_SHOWS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify show IDs. Maximum 50 IDs per request. Show IDs are 22-character base62 strings (e.g., '5CfCWKI5pZ28U0uOzXkDHe,5as3aKmN2k11yfDDDSrvaZ').
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'ES'). If specified, only content available in that market is returned. If not provided, content is considered available in all markets.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get several tracks
>
> **Slug:** `SPOTIFY_GET_SEVERAL_TRACKS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify track IDs (e.g., '7ouMYWpwJ422jRcDASZB7P,4VqPOruhp5EdPBeR92t6lQ'). Maximum 50 IDs per request.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB') to filter tracks by market availability. If not provided, content availability is not filtered by market.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get several tracks audio features
>
> **Slug:** `SPOTIFY_GET_SEVERAL_TRACKS_AUDIO_FEATURES`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify track IDs (e.g., '7ouMYWpwJ422jRcDASZB7P,4VqPOruhp5EdPBeR92t6lQ,2takcwOaAZWiXQijPHIx7B'). Maximum 100 IDs per request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get show
>
> **Slug:** `SPOTIFY_GET_SHOW`
>
> Get Spotify catalog information for a single show (podcast) identified by its unique Spotify ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID of the show. Show IDs are 22-character base62 strings (e.g., '5CfCWKI5pZ28U0uOzXkDHe' for The Joe Rogan Experience).
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code. If specified, only content available in that market is returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get show episodes
>
> **Slug:** `SPOTIFY_GET_SHOW_EPISODES`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID of the show (podcast). This must be a show ID, not an episode, track, or artist ID. Show IDs are 22-character base62 strings (e.g., '5CfCWKI5pZ28U0uOzXkDHe'). You can obtain show IDs from the search endpoint or from show objects returned by other endpoints.
>
> **limit** `integer`
>
> The maximum number of episodes to return. Default: 20. Minimum: 1. Maximum: 50.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'DE'). If specified, only episodes available in that market are returned. If not specified, the content is considered available in all markets.
>
> **offset** `integer`
>
> The index of the first episode to return. Default: 0 (the first episode). Use with limit to paginate through episodes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get single browse category
>
> **Slug:** `SPOTIFY_GET_SINGLE_BROWSE_CATEGORY`
>
> 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.
>
> #### Input Parameters
>
> **locale** `string`
>
> The desired language in the format of ISO 639-1 language code and ISO 3166-1 alpha-2 country code joined by underscore (e.g., 'es\_MX' for Spanish Mexico, 'sv\_SE' for Swedish Sweden). If not supplied or if the language is not available, returns the category in American English.
>
> **category\_id** `string` *required*
>
> The Spotify category ID for the category (e.g., 'dinner', 'party', 'pop')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get the user's queue
>
> **Slug:** `SPOTIFY_GET_THE_USER_S_QUEUE`
>
> 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
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get track
>
> **Slug:** `SPOTIFY_GET_TRACK`
>
> Get Spotify catalog information for a single track identified by its unique Spotify ID.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID of the track. Example: '11dFghVXANMlKmJXsNCbNl'
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'CA'). If provided, only content available in that market will be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Track's Audio Analysis
>
> **Slug:** `SPOTIFY_GET_TRACK_S_AUDIO_ANALYSIS`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID for the track. Example: '11dFghVXANMlKmJXsNCbNl'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get track's audio features
>
> **Slug:** `SPOTIFY_GET_TRACK_S_AUDIO_FEATURES`
>
> 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.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The Spotify ID for the track (e.g., '11dFghVXANMlKmJXsNCbNl').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get user's playlists
>
> **Slug:** `SPOTIFY_GET_USER_S_PLAYLISTS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of playlists to return in the response. Default: 20, Minimum: 1, Maximum: 50
>
> **offset** `integer`
>
> The index of the first playlist to return. Use with limit to paginate through results. Default: 0, Maximum: 100,000
>
> **user\_id** `string` *required*
>
> The Spotify user ID. This is the unique identifier for a Spotify user, which can be found in their profile URL (e.g., 'spotify', '31l77fd3xhkukh6jvqx8cktqyvw2')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get user's profile
>
> **Slug:** `SPOTIFY_GET_USER_S_PROFILE`
>
> 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.
>
> #### Input Parameters
>
> **user\_id** `string` *required*
>
> The Spotify user ID for the user. Example: 'smedjan'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get user s saved albums
>
> **Slug:** `SPOTIFY_GET_USER_S_SAVED_ALBUMS`
>
> 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
>
> #### Input Parameters
>
> **limit** `integer`
>
> The maximum number of albums to return. Default: 20. Minimum: 1. Maximum: 50.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB'). If provided, returns only content available in that market. If not provided, content is returned based on the user's account settings.
>
> **offset** `integer`
>
> The index of the first album to return. Use with limit to get the next set of albums. Default: 0.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get user s saved audiobooks
>
> **Slug:** `SPOTIFY_GET_USER_S_SAVED_AUDIOBOOKS`
>
> Get a list of the audiobooks saved in the current Spotify user's 'Your Music' library.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The maximum number of audiobooks to return. Default: 20. Minimum: 1. Maximum: 50.
>
> **offset** `integer`
>
> The index of the first audiobook to return. Default: 0 (the first item). Use with limit to get the next set of audiobooks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get user's saved episodes
>
> **Slug:** `SPOTIFY_GET_USER_S_SAVED_EPISODES`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The maximum number of episodes to return. Default: 20. Minimum: 1. Maximum: 50.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'ES'). If specified, only episodes available in that market are returned. If a valid user access token is provided, the user's country takes priority over this parameter.
>
> **offset** `integer`
>
> The index of the first episode to return. Default: 0 (the first episode). Use with limit to paginate through episodes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User's Saved Shows
>
> **Slug:** `SPOTIFY_GET_USER_S_SAVED_SHOWS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The maximum number of items to return. Default: 20. Range: 1-50.
>
> **offset** `integer`
>
> The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User's Saved Tracks
>
> **Slug:** `SPOTIFY_GET_USER_S_SAVED_TRACKS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The maximum number of items to return per page. Must be between 1 and 50. Default is 20.
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'CA'). If provided, only content available in that market is returned. If not provided, content is returned based on the user's account settings.
>
> **offset** `integer`
>
> The index of the first item to return (zero-based). Use with limit to paginate through results. Default is 0 (the first item).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User's Top Artists
>
> **Slug:** `SPOTIFY_GET_USER_S_TOP_ARTISTS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The maximum number of items to return. Must be between 1 and 50. Default: 20.
>
> **offset** `integer`
>
> The index of the first item to return (for pagination). Default: 0 (the first item). Use with limit to get the next set of items.
>
> **time\_range** `string ("long_term" | "medium_term" | "short_term")`
>
> Over what time frame the affinities are computed. long\_term (\~1 year), medium\_term (\~6 months), short\_term (\~4 weeks). Default: medium\_term.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User's Top Tracks
>
> **Slug:** `SPOTIFY_GET_USER_S_TOP_TRACKS`
>
> 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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of tracks to return. Minimum: 1, Maximum: 50.
>
> **offset** `integer`
>
> The index of the first track to return. Use with limit to paginate through results. Default: 0 (first track).
>
> **time\_range** `string`
>
> Time period for computing affinity. Options: 'long\_term' (calculated from \~1 year of data), 'medium\_term' (approximately last 6 months), 'short\_term' (approximately last 4 weeks).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Pause playback
>
> **Slug:** `SPOTIFY_PAUSE_PLAYBACK`
>
> 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
>
> #### Input Parameters
>
> **device\_id** `string`
>
> The ID of the device to pause playback on. If not provided, playback will be paused on the currently active device. Use the 'get\_available\_devices' action to retrieve device IDs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove playlist items
>
> **Slug:** `SPOTIFY_REMOVE_PLAYLIST_ITEMS`
>
> 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.
>
> #### Input Parameters
>
> **tracks** `array` *required*
>
> An array of objects containing Spotify URIs of the tracks or episodes to remove. For example: \[\{"uri": "spotify:track:4iV5W9uYEdYUVa79Axb7Rh"}, \{"uri": "spotify:track:1301WleyT98MSxVHPZCA6M"}]. A maximum of 100 objects can be sent at once. Optionally include "positions" to remove specific occurrences.
>
> **playlist\_id** `string` *required*
>
> The Spotify ID of the playlist (e.g., '3cEYpjA9oz9GiPac4AsH4n').
>
> **snapshot\_id** `string`
>
> The playlist's snapshot ID against which you want to make the changes. The API will validate that the specified items exist and in the specified positions and make the changes, even if more recent changes have been made to the playlist.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove users saved albums
>
> **Slug:** `SPOTIFY_REMOVE_USERS_SAVED_ALBUMS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify album IDs (for query parameter, max 20 IDs) or a list of album IDs (for request body, max 50 IDs). Example (string): '382ObEPsp2rxGrnsizN5TX,1A2GTWGtFfWp7KSQTwWOyo,2noRn2Aes5aoNVsU6iWThc' Example (list): \['4iV5W9uYEdYUVa79Axb7Rh', '1301WleyT98MSxVHPZCA6M']
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove User's Saved Audiobooks
>
> **Slug:** `SPOTIFY_REMOVE_USER_S_SAVED_AUDIOBOOKS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of the Spotify IDs for the audiobooks to remove. Maximum: 50 IDs. Audiobook IDs are 22-character base62 strings (e.g., '18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove user's saved episodes
>
> **Slug:** `SPOTIFY_REMOVE_USER_S_SAVED_EPISODES`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify episode IDs (e.g., '4iV5W9uYEdYUVa79Axb7Rh,1301WleyT98MSxVHPZCA6M') or a list of episode IDs (e.g., \['4iV5W9uYEdYUVa79Axb7Rh', '1301WleyT98MSxVHPZCA6M']). Maximum of 50 IDs per request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove user s saved shows
>
> **Slug:** `SPOTIFY_REMOVE_USER_S_SAVED_SHOWS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string`
>
> A comma-separated list of Spotify show IDs to remove from the user's library. Maximum: 50 IDs per request. Example: '5CfCWKI5pZ28U0uOzXkDHe,5as3aKmN2k11yfDDDSrvaZ'
>
> **market** `string`
>
> An ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB'). If provided, only shows available in that market will be considered. The user's account country takes priority if a valid access token is provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove user s saved tracks
>
> **Slug:** `SPOTIFY_REMOVE_USER_S_SAVED_TRACKS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string`
>
> A comma-separated list of Spotify track IDs to remove from the user's library (e.g., '7ouMYWpwJ422jRcDASZB7P,4VqPOruhp5EdPBeR92t6lQ,2takcwOaAZWiXQijPHIx7B'). Maximum 50 IDs per request. Note: If this query parameter is provided, any IDs in the request body will be ignored.
>
> **body\_ids** `array`
>
> A JSON array of Spotify track IDs to remove from the user's library. For example: \["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]. Maximum 50 items can be specified in one request. Note: If the 'ids' query parameter is present, this body parameter will be ignored.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Save albums for current user
>
> **Slug:** `SPOTIFY_SAVE_ALBUMS_FOR_CURRENT_USER`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify album IDs (for query parameter, max 20 IDs) or a list of album IDs (for request body, max 50 IDs). Example (string): '4aawyAB9vmqN3uQ7FjRGTy,2up3OPMp9Tb4dAKM2erWXQ' Example (list): \['4iV5W9uYEdYUVa79Axb7Rh', '1301WleyT98MSxVHPZCA6M']
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Save audiobooks for current user
>
> **Slug:** `SPOTIFY_SAVE_AUDIOBOOKS_FOR_CURRENT_USER`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify audiobook IDs to save to the user's library. Maximum of 50 IDs. Example: '18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ,7iHfbu1YPACw6oZPAFJtqe'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Save episodes for current user
>
> **Slug:** `SPOTIFY_SAVE_EPISODES_FOR_CURRENT_USER`
>
> 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.
>
> #### Input Parameters
>
> **ids** `array` *required*
>
> A list of Spotify episode IDs to save to the current user's library. Maximum of 50 IDs can be specified in one request. Episode IDs are 22-character base62 strings (e.g., \['77o6BIVlYM3msb4MMIL1jH', '0Q86acNRm6V9GYx55SXKwf']). You can obtain episode IDs from the search endpoint, show episodes endpoint, or get several episodes endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Save shows for current user
>
> **Slug:** `SPOTIFY_SAVE_SHOWS_FOR_CURRENT_USER`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of the Spotify IDs for the shows. Maximum: 50 IDs. Example: '5CfCWKI5pZ28U0uOzXkDHe,5as3aKmN2k11yfDDDSrvaZ'
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Save tracks for current user
>
> **Slug:** `SPOTIFY_SAVE_TRACKS_FOR_CURRENT_USER`
>
> 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.
>
> #### Input Parameters
>
> **ids** `array`
>
> A list of Spotify track IDs to save to the user's library. Maximum of 50 items. Example: \['4iV5W9uYEdYUVa79Axb7Rh', '1301WleyT98MSxVHPZCA6M']. Note: If 'timestamped\_ids' is provided, this field will be ignored.
>
> **timestamped\_ids** `array`
>
> A list of objects containing track IDs with their corresponding timestamps. Use this to specify when tracks were added to maintain chronological order. Maximum of 50 items. If provided, 'ids' field will be ignored.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search for item
>
> **Slug:** `SPOTIFY_SEARCH_FOR_ITEM`
>
> 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.
>
> #### Input Parameters
>
> **q** `string` *required*
>
> Q
>
> **type** `array` *required*
>
> Type
>
> **limit** `integer`
>
> Limit
>
> **market** `string`
>
> Market
>
> **offset** `integer`
>
> Offset
>
> **include\_external** `string ("audio")`
>
> Include External
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Seek to position
>
> **Slug:** `SPOTIFY_SEEK_TO_POSITION`
>
> 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.
>
> #### Input Parameters
>
> **device\_id** `string`
>
> The ID of the device to target for this command. If not supplied, the user's currently active device will be targeted. You can get device IDs from the get\_available\_devices action.
>
> **position\_ms** `integer` *required*
>
> The position in milliseconds to seek to in the currently playing track. Must be a positive number (0 or greater). If you pass a position greater than the track's duration, playback will skip to the next track. Example: 30000 for 30 seconds, 60000 for 1 minute.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set playback volume
>
> **Slug:** `SPOTIFY_SET_PLAYBACK_VOLUME`
>
> 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.
>
> #### Input Parameters
>
> **device\_id** `string`
>
> The ID of the device this command is targeting. If not supplied, the user's currently active device is the target.
>
> **volume\_percent** `integer` *required*
>
> Volume percentage to set. Must be a value from 0 to 100 inclusive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set repeat mode
>
> **Slug:** `SPOTIFY_SET_REPEAT_MODE`
>
> 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
>
> #### Input Parameters
>
> **state** `string ("track" | "context" | "off")` *required*
>
> The repeat mode to set: track (repeat current track), context (repeat current context/playlist/album), or off (turn repeat off).
>
> **device\_id** `string`
>
> The ID of the device to target. If not provided, the user's currently active device will be targeted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Skip to next
>
> **Slug:** `SPOTIFY_SKIP_TO_NEXT`
>
> 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.
>
> #### Input Parameters
>
> **device\_id** `string`
>
> The ID of the device this command is targeting. If not supplied, the user's currently active device is the target.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Skip to previous
>
> **Slug:** `SPOTIFY_SKIP_TO_PREVIOUS`
>
> 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.
>
> #### Input Parameters
>
> **device\_id** `string`
>
> The id of the device this command is targeting. If not supplied, the user's currently active device is the target.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Start resume playback
>
> **Slug:** `SPOTIFY_START_RESUME_PLAYBACK`
>
> 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.
>
> #### Input Parameters
>
> **uris** `array`
>
> List of Spotify track URIs to play. Example: \['spotify:track:4iV5W9uYEdYUVa79Axb7Rh', 'spotify:track:1301WleyT98MSxVHPZCA6M']. Cannot be used with 'context\_uri' parameter.
>
> **offset** `object`
>
> Starting position in the context. Only available when 'context\_uri' is an album or playlist. Use either 'position' (zero-based track index) or 'uri' (specific track URI). Example with position: \{'position': 5}. Example with URI: \{'uri': 'spotify:track:1301WleyT98MSxVHPZCA6M'}.
>
> **device\_id** `string`
>
> The ID of the device to target for playback. If not provided, playback will start/resume on the currently active device. Use the 'get\_available\_devices' action to retrieve device IDs.
>
> **context\_uri** `string`
>
> Spotify URI of the context to play. Valid contexts are albums, artists, or playlists. Example: 'spotify:album:1Je1IMUlBXcx1Fz0WE7oPT' or 'spotify:playlist:37i9dQZF1DXcBWIGoYBM5M'. Cannot be used with 'uris' parameter.
>
> **position\_ms** `integer`
>
> Position in milliseconds to start playback. Must be a positive number. If greater than the track length, the player will skip to the next song. Example: 25000 (starts 25 seconds into the track).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Toggle playback shuffle
>
> **Slug:** `SPOTIFY_TOGGLE_PLAYBACK_SHUFFLE`
>
> 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.
>
> #### Input Parameters
>
> **state** `boolean` *required*
>
> true: Enable shuffle for user's playback. false: Disable shuffle for user's playback.
>
> **device\_id** `string`
>
> The ID of the device to target for playback control. If not provided, the command will target the user's currently active device. Device IDs can be retrieved from the Get Available Devices endpoint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Transfer playback
>
> **Slug:** `SPOTIFY_TRANSFER_PLAYBACK`
>
> 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.
>
> #### Input Parameters
>
> **play** `boolean`
>
> Whether to start playback on the new device. If true, playback will start on the new device. If false or not provided, the current playback state is maintained.
>
> **device\_ids** `array` *required*
>
> List containing the device ID to transfer playback to. Note: Only a single device\_id is currently supported by Spotify API. Obtain device IDs using the get\_available\_devices action. Example: \['74ASZWbe4lXaubB36ztrGX']
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Unfollow artists or users
>
> **Slug:** `SPOTIFY_UNFOLLOW_ARTISTS_OR_USERS`
>
> 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.
>
> #### Input Parameters
>
> **ids** `string` *required*
>
> A comma-separated list of Spotify IDs for the artists or users to unfollow. For example: '2CIMQHirSU0MQqyYHq0eOx,57dN52uHvrHOxijzpIgu3E'. A maximum of 50 IDs can be sent in one request.
>
> **type** `string ("artist" | "user")` *required*
>
> The type of Spotify entity to unfollow. Use 'artist' to unfollow musical artists/bands, or 'user' to unfollow other Spotify users.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Unfollow playlist
>
> **Slug:** `SPOTIFY_UNFOLLOW_PLAYLIST`
>
> 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.
>
> #### Input Parameters
>
> **playlist\_id** `string` *required*
>
> The Spotify ID of the playlist to unfollow. This is a 22-character base62 string that uniquely identifies the playlist (e.g., '37i9dQZF1DXcBWIGoYBM5M').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update playlist items
>
> **Slug:** `SPOTIFY_UPDATE_PLAYLIST_ITEMS`
>
> 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.
>
> #### Input Parameters
>
> **uris** `string`
>
> **\[REPLACE MODE]** Spotify URIs of tracks or episodes to replace the entire playlist with. Accepts either: - Comma-separated string: 'spotify:track:4iV5W9uYEdYUVa79Axb7Rh,spotify:track:1301WleyT98MSxVHPZCA6M' - List of strings: \['spotify:track:4iV5W9uYEdYUVa79Axb7Rh', 'spotify:track:1301WleyT98MSxVHPZCA6M'] Maximum 100 items per request. This will overwrite ALL existing tracks in the playlist. **NOTE**: Cannot be used with reorder parameters (range\_start, insert\_before, range\_length).
>
> **playlist\_id** `string` *required*
>
> The Spotify ID of the playlist (e.g., '3cEYpjA9oz9GiPac4AsH4n'). Can be found in the playlist URL or obtained from playlist creation/search endpoints.
>
> **range\_start** `integer`
>
> **\[REORDER MODE]** Zero-based index of the first track to be reordered. Example: range\_start=0 means start from the first track. **NOTE**: Cannot be used with `uris` parameter.
>
> **snapshot\_id** `string`
>
> **\[REORDER MODE]** The playlist's snapshot ID to validate against before making changes. Can be obtained from playlist get/create/update responses and used to identify the playlist version to target. **NOTE**: Cannot be used with `uris` parameter.
>
> **range\_length** `integer`
>
> **\[REORDER MODE]** Number of consecutive tracks to reorder starting from `range_start`. Defaults to 1 if not specified. Example: range\_length=2 means move 2 tracks. **NOTE**: Cannot be used with `uris` parameter.
>
> **insert\_before** `integer`
>
> **\[REORDER MODE]** Zero-based position where the tracks should be moved to. Examples: - To move first track to end (10 tracks): range\_start=0, insert\_before=10 - To move last track to start (10 tracks): range\_start=9, insert\_before=0 - To move tracks at positions 9-10 to start: range\_start=9, insert\_before=0, range\_length=2 **NOTE**: Cannot be used with `uris` parameter.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

## Triggers

> [accordion] New Device Added
>
> **Slug:** `SPOTIFY_NEW_DEVICE_TRIGGER`
>
> **Type:** poll
>
> Triggers when a new device is added.
>
> #### Configuration
>
> **interval** `number`
>
> Periodic Interval to Check for Updates & Send a Trigger in Minutes
>
> #### Payload
>
> **device** `object` *required*
>
> Device details
>
> **event\_type** `string` *required*
>
> Type of device event (added/removed)

> [accordion] Spotify Playlist Item Change
>
> **Slug:** `SPOTIFY_PLAYLIST_ITEM_TRIGGER`
>
> **Type:** poll
>
> Triggers when songs are added to or removed from a Spotify playlist.
>
> #### Configuration
>
> **interval** `number`
>
> Periodic Interval to Check for Updates & Send a Trigger in Minutes
>
> **playlist\_id** `string` *required*
>
> The ID of the Spotify playlist
>
> #### Payload
>
> **event\_type** `string` *required*
>
> Type of playlist item event (added/removed)
>
> **track** `object` *required*
>
> Track details

> [accordion] New Playlist Created or Deleted
>
> **Slug:** `SPOTIFY_PLAYLIST_TRIGGER`
>
> **Type:** poll
>
> Triggers when a new playlist is created or deleted.
>
> #### Configuration
>
> **interval** `number`
>
> Periodic Interval to Check for Updates & Send a Trigger in Minutes
>
> #### Payload
>
> **event\_type** `string` *required*
>
> Type of playlist event (created/deleted)
>
> **playlist** `object` *required*
>
> Playlist details
