---
title: Create a New Library Playlist Folder
framework: Apple Music API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple music 1.0+]
path: applemusicapi/create-a-new-library-playlist-folder
---

# Create a New Library Playlist Folder

Create a new playlist folder in a user’s library.

## URL

POST https://api.music.apple.com/v1/me/library/playlist-folders

## Query Parameters

l: 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

201 Created: The request was successful. 401 Unauthorized: A response indicating an incorrect Authorization header. 403 Forbidden: A response indicating invalid or insufficient authentication. 500 Internal Server Error: A response indicating an error occurred on the server.

## Discussion

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. note: There may be a delay before a new resource appears in a user’s library. Example

## HTTP Body

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

## See Also

### Related Documentation

- [LibraryPlaylists](applemusicapi/libraryplaylists.md)
- [LibraryPlaylistsResponse](applemusicapi/libraryplaylistsresponse.md)

### Handling Library Playlist Folders

- [Get Root Library Playlists Folder](applemusicapi/get-root-library-playlists-folder.md)
- [Get a Library Playlist Folder](applemusicapi/get-a-library-playlist-folder.md)
- [Get a Library Playlist Folder’s Relationship Directly by Name](applemusicapi/fetch-a-relationship-on-this-resource-by-name-r5gv.md)
- [Get Multiple Library Playlist Folders](applemusicapi/get-multiple-library-playlist-folders.md)
- [LibraryPlaylistFolderCreationRequest](applemusicapi/libraryplaylistfoldercreationrequest.md)