View as Markdown
Spotify icon

Spotify ACTION

Create a Playlist

Create a playlist for a Spotify user. The playlist will be empty until you add tracks. See the docs here.
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Spotify account once, then configure and run Create a Playlist from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "spotify-create-playlist",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    spotify: { authProvisionId: "apn_xxxxxxx" },
    name: "Name",
    description: "Description",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create a Playlist inputs
Property Type Description
name Name string
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.
Required
description Description string
Value for playlist description as displayed in Spotify Clients and in the Web API.
Optional
isPublic Public boolean
Defaults to true. If true the playlist will be public, if false it will be private.
Optional
isCollaborative Collaborative boolean
Defaults to false. If true the playlist will be collaborative. Note that to create a collaborative playlist you must also set public to false.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
spotify-create-playlist
Version
0.1.8
App
Spotify
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes