Web Service Endpoint

Add a Resource to a Library

Add a catalog resource to a user’s iCloud Music Library.


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

Query Parameters


The unique catalog identifiers for the resources. To indicate the type of resource to be added, ids must be followed by one of the allowed values. Multiple types can be added in the same request.

Response Codes

202 Accepted

The modification request was accepted but may not have completed.


If successful, the HTTP status code is 202 (Accepted) and there is no response body. Requested IDs that cannot be added to the library are ignored. If unsuccessful, the HTTP status code indicates the error and the details are in the errors array. See Handle a Response.

This endpoint requires a music user token. See Getting Keys and Creating Tokens.


No response body