Create a New Library Playlist

Create a new playlist in a user’s library.

URL

POST https://api.music.apple.com/v1/me/library/playlists

Query Parameters

Name	Type	Description
`l` Optional	string	The localization to use, specified by a language tag. The possible values are in the `supportedLanguageTags` array belonging to the `Storefront` object specified by `storefront`. Otherwise, the default is `defaultLanguageTag` in `Storefront`.

Response Codes

Status	Reason	Type	Description
201	Created Content-Type: application/json	`LibraryPlaylistsResponse`	The request was successful.
401	Unauthorized Content-Type: application/json	`UnauthorizedResponse`	A response indicating an incorrect `Authorization` header.
403	Forbidden Content-Type: application/json	`ForbiddenResponse`	A response indicating invalid or insufficient authentication.
500	Internal Server Error Content-Type: application/json	`ErrorsResponse`	A response indicating an error occurred on the server.

Discussion

If successful, the HTTP status code is 201 (Created) and a new resource created as a result. If unsuccessful, the HTTP status code indicates the error and the details are in the errors array.

This endpoint requires a music user token. For more information, see User Authentication for MusicKit.

You can include an optional tracks relationship in this request.

Example

HTTP Body

The POST request containing the name, tracks and parent playlist folder for the playlist to be added.