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-foldersQuery Parameters
| Name | Type | Description |
|---|---|---|
l Optional | string | The localization to use, specified by a language tag. The possible values are in the |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 201 | Created Content-Type: application/json | LibraryPlaylistFoldersResponse | The request was successful. |
| 401 | Unauthorized Content-Type: application/json | UnauthorizedResponse | A response indicating an incorrect |
| 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.
Example
HTTP Body
The POST request containing the name and parent playlist folder for the playlist folder to be added.