> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Photos

> Google Photos is a cloud-based photo storage and organization service offering automatic backups, AI-assisted search, and shared albums for personal and collaborative media management

![Google Photos logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/googlephotos.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=c435e47a45870fe7f5ef74997d9fa3e0)

* **Category:** images & design
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** Yes
* **Tools:** 14
* **Triggers:** 0
* **Slug:** `GOOGLEPHOTOS`
* **Version:** 20261101\_00

## Tools

> [accordion] Add Enrichment
>
> **Slug:** `GOOGLEPHOTOS_ADD_ENRICHMENT`
>
> Adds a text, location, or map enrichment at a specified position in a Google Photos album created by this app.
>
> #### Input Parameters
>
> **albumId** `string` *required*
>
> Identifier of the album where the enrichment is to be added
>
> **albumPosition** `object` *required*
>
> Position in the album where the enrichment is to be inserted. Required field with valid position types: FIRST\_IN\_ALBUM, LAST\_IN\_ALBUM, AFTER\_MEDIA\_ITEM (requires relativeMediaItemId), AFTER\_ENRICHMENT\_ITEM (requires relativeEnrichmentItemId)
>
> **newEnrichmentItem** `object` *required*
>
> The enrichment to be added, can be a text, location, or map enrichment
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Batch Add Media Items
>
> **Slug:** `GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMS`
>
> Adds one or more app-created media items to an app-created Google Photos album.
>
> #### Input Parameters
>
> **albumId** `string` *required*
>
> Identifier of the Album that the media items are added to. Must be an album created by this application.
>
> **mediaItemIds** `array` *required*
>
> Identifiers of the MediaItems to be added. Maximum 50 items. Media items must be created by this application.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Batch Create Media Items
>
> **Slug:** `GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMS`
>
> Uploads and creates up to 50 Google Photos media items from public URLs or uploaded files, optionally placing them at a specific position in an app-created album. Creating media requires the photoslibrary.appendonly authorization scope, which is not included in the toolkit's default scopes.
>
> #### Input Parameters
>
> **urls** `array`
>
> Simplified input: List of public URLs of media files to upload. File names will be extracted from URLs automatically. Use 'media\_files' for more control over file names and descriptions.
>
> **files** `array`
>
> List of files to upload to Google Photos.
>
> **albumId** `string`
>
> Optional identifier of the album where the media items are to be added. If not specified, media items are added to the user's library only.
>
> **media\_files** `array`
>
> List of media files to upload. Each item can specify either a 'url' (public URL) or a 'file' (FileUploadable object). Maximum 50 items per request.
>
> **albumPosition** `object`
>
> Position in the album to add the media items.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Batch Get Media Items
>
> **Slug:** `GOOGLEPHOTOS_BATCH_GET_MEDIA_ITEMS`
>
> Returns app-created Google Photos media items for the specified media item identifiers.
>
> #### Input Parameters
>
> **mediaItemIds** `array` *required*
>
> Identifiers of the media items to be requested. Must not contain duplicates.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Album
>
> **Slug:** `GOOGLEPHOTOS_CREATE_ALBUM`
>
> Creates a new album in Google Photos. This requires the photoslibrary.appendonly scope, which is not included in the default authorization scopes.
>
> #### Input Parameters
>
> **title** `string` *required*
>
> Name of the album to be created in Google Photos. Maximum 500 characters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Album
>
> **Slug:** `GOOGLEPHOTOS_GET_ALBUM`
>
> Retrieves a Google Photos album created by this app by its ID.
>
> #### Input Parameters
>
> **albumId** `string` *required*
>
> Identifier of the album to be requested.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Photos Media Item
>
> **Slug:** `GOOGLEPHOTOS_GET_MEDIA_ITEM_DOWNLOAD`
>
> Downloads an app-created Google Photos media item and returns it as a file.
>
> #### Input Parameters
>
> **mediaItemId** `string` *required*
>
> ID of the media item to download
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Albums
>
> **Slug:** `GOOGLEPHOTOS_LIST_ALBUMS`
>
> Lists Google Photos albums created by this app, with pagination support.
>
> #### Input Parameters
>
> **pageSize** `integer`
>
> Maximum number of albums to return. Default 20, maximum 50.
>
> **pageToken** `string`
>
> Continuation token for getting the next page of results
>
> **excludeNonAppCreatedData** `boolean`
>
> If true, excludes media items not created by this app
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Media Items (App-Created Only)
>
> **Slug:** `GOOGLEPHOTOS_LIST_MEDIA_ITEMS`
>
> Lists photos and videos created by this application in the user's Google Photos library, with pagination. It cannot list the user's entire library.
>
> #### Input Parameters
>
> **pageSize** `integer`
>
> Maximum number of items to return. Default 25, maximum 100.
>
> **pageToken** `string`
>
> Token for getting the next page of results
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Shared Albums (Deprecated)
>
> **Slug:** `GOOGLEPHOTOS_LIST_SHARED_ALBUMS`
>
> Lists shared albums visible in the user's Google Photos Sharing tab, with pagination. DEPRECATED: Google removed shared-album listing after March 31, 2025; use the Google Photos app to manage sharing instead.
>
> #### Input Parameters
>
> **pageSize** `integer`
>
> Maximum number of albums to return. Default 20, maximum 50.
>
> **pageToken** `string`
>
> Continuation token for getting the next page of results. Use the value returned in nextPageToken from the previous response.
>
> **excludeNonAppCreatedData** `boolean`
>
> If true, excludes media items not created by this app. Defaults to false (all albums are returned). This field is ignored if the photoslibrary.readonly.appcreateddata scope is used.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Media Items
>
> **Slug:** `GOOGLEPHOTOS_SEARCH_MEDIA_ITEMS`
>
> Searches for app-created media items in a user's Google Photos library.
>
> #### Input Parameters
>
> **albumId** `string`
>
> Album to search within
>
> **filters** `object`
>
> Search filters
>
> **orderBy** `string`
>
> Sort order for results, e.g. 'MediaMetadata.creation\_time desc'
>
> **pageSize** `integer`
>
> Maximum number of items to return. Default 25, maximum 100.
>
> **pageToken** `string`
>
> Token for getting the next page
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Album
>
> **Slug:** `GOOGLEPHOTOS_UPDATE_ALBUM`
>
> Updates the title or cover photo of a Google Photos album created by this app.
>
> #### Input Parameters
>
> **title** `string`
>
> New title for the album. Maximum 500 characters.
>
> **albumId** `string` *required*
>
> Identifier of the album to update
>
> **coverPhotoMediaItemId** `string`
>
> ID of the media item to use as album cover photo
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Media Item
>
> **Slug:** `GOOGLEPHOTOS_UPDATE_MEDIA_ITEM`
>
> Updates the description of an app-created media item in Google Photos.
>
> #### Input Parameters
>
> **description** `string` *required*
>
> New description for the media item. Must be shorter than 1000 characters.
>
> **mediaItemId** `string` *required*
>
> Identifier of the media item to update
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Media
>
> **Slug:** `GOOGLEPHOTOS_UPLOAD_MEDIA`
>
> Upload an image or video to Google Photos from a file or public URL and create a media item. Uploading requires the photoslibrary.appendonly authorization scope, which is not included in the default connection scopes.
>
> #### Input Parameters
>
> **url** `string`
>
> Public URL of the media file to upload (must be directly accessible). The action will download the file from this URL and upload it to Google Photos. Alternative to 'file\_to\_upload'. Supported formats: images (JPEG, PNG, GIF, HEIC, etc.) and videos (MP4, MOV, etc.).
>
> **file\_name** `string`
>
> File name for the uploaded media. Required when using 'url' parameter. Should include the file extension (e.g., 'photo.jpg', 'video.mp4').
>
> **description** `string`
>
> Optional description for the media item
>
> **file\_to\_upload** `object`
>
> The media file to upload to Google Photos.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
