--- title: "POST /users/{user_id}/playlists" method: POST path: "/users/{user_id}/playlists" --- # POST /users/{user_id}/playlists `POST /users/{user_id}/playlists` [Create a Playlist](https://developer.spotify.com/web-api/create-playlist/) ## Path parameters - `user_id` string, required ## Headers - `Accept` string ## Request body - object - `name` string, required - `public` boolean ## Response `201` Created - Playlist - `collaborative` boolean — True if the owner allows other users to modify the playlist. - `description` string — The playlist description. Only returned for modified, verified playlists, otherwise null. - `external_urls` object — Known external URLs for this album. - `followers` object — Information about the followers of the playlist. - `href` string — A link to the Web API endpoint providing full details of the followers; null if not available. - `total` integer — The total number of followers. - `href` string — A link to the Web API endpoint providing full details of the playlist. - `id` string — The Spotify ID of the playlist. - `images` Image[] — The cover art for the album in various sizes, widest first. - `height` integer — The image height in pixels. If unknown: null or not returned. - `url` string — The source URL of the image. - `width` integer — The image width in pixels. If unknown: null or not returned. - `name` string — The name of the playlist. - `owner` UserProfile - `displayName` string — The name displayed on the user's profile. - `external_urls` object — Known external URLs for this user. - `followers` Followers — Information about the followers of the artist. - `href` string — A link to the Web API endpoint providing full details of the followers; null if not available. - `total` integer — The total number of followers. - `href` string — A link to the Web API endpoint for this user. - `id` string — The Spotify ID for this user. - `type` string — The object type: 'user' - `uri` string — The Spotify URI for the user. - `public` boolean — The playlist's public/private status: true the playlist is public, false the playlist is private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists. - `snapshot_id` string — The version identifier for the current playlist. Can be supplied in other requests to target a specific playlist version - `tracks` PlaylistTrackPage - `href` string — A link to the Web API endpoint returning the full result of the request. - `items` PlaylistTrack[] — The requested data. - `added_at` string — The date and time the track was added in ISO 8601 format. Note that some very old playlists may return null in this field. - `added_by` UserProfile - `displayName` string — The name displayed on the user's profile. - `external_urls` object — Known external URLs for this user. - `followers` Followers — Information about the followers of the artist. - `href` string — A link to the Web API endpoint providing full details of the followers; null if not available. - `total` integer — The total number of followers. - `href` string — A link to the Web API endpoint for this user. - `id` string — The Spotify ID for this user. - `type` string — The object type: 'user' - `uri` string — The Spotify URI for the user. - `is_local` boolean — Whether this track is a [local file](https://developer.spotify.com/web-api/local-files-spotify-playlists/) or not. - `track` Track - `album` AlbumSimple - `album_type` string — The type of the album: one of 'album', 'single', or 'compilation'. - `available_markets` string[] — The markets in which the album is available: ISO 3166-1 alpha-2 country codes. Note that an album is considered available in a market when at least 1 of its tracks is available in that market. - `external_urls` object — Known external URLs for this album. - `href` string — A link to the Web API endpoint providing full details of the album. - `id` string — The Spotify ID for the album. - `images` Image[] — The cover art for the album in various sizes, widest first. - `height` integer — The image height in pixels. If unknown: null or not returned. - `url` string — The source URL of the image. - `width` integer — The image width in pixels. If unknown: null or not returned. - `name` string — The name of the album. - `type` string — The object type: 'album'. - `uri` string — The Spotify URI for the album. - `artists` ArtistSimple[] — The artists who performed the track. Each artist object includes a link in href to more detailed information about the artist. - `external_urls` object — Known external URLs for this artist. - `href` string — A link to the Web API endpoint providing full details of the artist. - `id` string — The Spotify ID for the artist. - `name` string — The name of the artist. - `type` string — The object type: 'artist' - `uri` string — The Spotify URI for the artist. - `available_markets` string[] — A list of the countries in which the track can be played, identified by their ISO 3166-1 alpha-2 code. - `disc_number` integer — The disc number (usually 1 unless the album consists of more than one disc). - `duration_ms` integer — The track length in milliseconds. - `explicit` boolean — Whether or not the track has explicit lyrics (true = yes it does; false = no it does not OR unknown). - `external_ids` object — Known external IDs for the track. - `external_urls` object — Known external URLs for this track. - `href` string — A link to the Web API endpoint providing full details of the track. - `id` string — The Spotify ID for the track. - `is_playable` boolean — Part of the response when Track Relinking is applied. If true, the track is playable in the given market. Otherwise false. - `linked_from` object — Part of the response when Track Relinking is applied, and the requested track has been replaced with different track. The track in the linked_from object contains information about the originally requested track. - `external_urls` object — Known external URLs for this track. - `href` string — A link to the Web API endpoint providing full details of the track. - `id` string — The Spotify ID for the track. - `type` string — The object type: 'track'. - `uri` string — The Spotify URI for the track. - `name` string — The name of the track. - `preview_url` string — A URL to a 30 second preview (MP3 format) of the track. - `track_number` integer — The number of the track. If an album has several discs, the track number is the number on the specified disc. - `type` string — The object type: 'track'. - `uri` string — The Spotify URI for the track. - `limit` integer — The maximum number of items in the response (as set in the query or by default). - `next` string — URL to the next page of items. (null if none) - `offset` integer — The offset of the items returned (as set in the query or by default). - `previous` string — URL to the previous page of items. (null if none) - `total` integer — The total number of items available to return. - `type` string — The object type: 'playlist'. - `uri` string — Spotify URI of the playlist. ## Other responses - `429` — API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details. --- [API](https://skmtc.net/isa-group/apis/spotify.md) · [All operations](https://skmtc.net/isa-group/apis/spotify/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/isa-group/spotify/versions/acd86d5cc241/schema)