---
title: Add a Resource to a Library
framework: Apple Music API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple music 1.0+]
path: applemusicapi/add-a-resource-to-a-library
---

# Add a Resource to a Library

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

## URL

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

## Query Parameters

ids: The unique catalog identifiers for the resources. To indicate the type of resource to add, follow the ids with one of the allowed values. Add multiple types in the same request. l: The localization to use, specified by a language tag. The possible values are in the supportedLanguageTags array belonging to the Storefront object that storefront specifies. Otherwise, the default is defaultLanguageTag in Storefront.

## Response Codes

202 Accepted: Although the modification request was acceptable, it may not have completed. 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 202 (Accepted) and there is no response body. For requested IDs that can’t be added to a user’s library, Apple Music Library ignores those IDs. 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

## See Also

### Related Documentation

- [Resource](applemusicapi/resource.md)