Method: albums.create

  • Creates a new album within a user's Google Photos library using a POST request.

  • The request body should contain the album details in JSON format, specifying properties like title and description.

  • A successful response returns the newly created album object with its assigned ID and other relevant information.

  • Requires authorization using one of the specified OAuth scopes to access and modify the user's Google Photos library.

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
  • https://www.googleapis.com/auth/photoslibrary.appendonly
  • https://www.googleapis.com/auth/photoslibrary.sharing