Method: albums.create

AI-generated Key Takeaways

• This documentation outlines the process for creating an album in a user's Google Photos library using the Photos Library API.

• The API request involves sending a POST request to a specific endpoint with a JSON body containing the album details.

• A successful response will return the newly created album object, including its properties and metadata.

• Authentication requires one of the provided OAuth scopes to grant necessary permissions.

• Beginning March 31, 2025, the scopes will change to limit functionality to media items created by the user's application, as outlined in the Photos APIs updates document.

• HTTP request
• Request body
  • JSON representation
• Response body
• Authorization scopes
• Try it!

Creates an album in a user's Google Photos library.

HTTP request

POST https://photoslibrary.googleapis.com/v1/albums

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
{ "album": { object (Album) } }

Fields
album	object (Album) Required. The album to be created.

Response body

If successful, the response body contains a newly created instance of Album.

Authorization scopes

Requires one of the following OAuth scopes:

• https://www.googleapis.com/auth/photoslibrary.appendonly