Skip to main content
Google Photos logo
  • Category: images & design
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 14
  • Triggers: 0
  • Slug: GOOGLEPHOTOS
  • Version: 20261101_00

Tools

Slug: GOOGLEPHOTOS_ADD_ENRICHMENTAdds a text, location, or map enrichment at a specified position in a Google Photos album created by this app.

Input Parameters

string
required
Identifier of the album where the enrichment is to be added
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)
object
required
The enrichment to be added, can be a text, location, or map enrichment

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_BATCH_ADD_MEDIA_ITEMSAdds one or more app-created media items to an app-created Google Photos album.

Input Parameters

string
required
Identifier of the Album that the media items are added to. Must be an album created by this application.
array
required
Identifiers of the MediaItems to be added. Maximum 50 items. Media items must be created by this application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_BATCH_CREATE_MEDIA_ITEMSUploads 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

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.
array
List of files to upload to Google Photos.
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.
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.
object
Position in the album to add the media items.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_BATCH_GET_MEDIA_ITEMSReturns app-created Google Photos media items for the specified media item identifiers.

Input Parameters

array
required
Identifiers of the media items to be requested. Must not contain duplicates.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_CREATE_ALBUMCreates a new album in Google Photos. This requires the photoslibrary.appendonly scope, which is not included in the default authorization scopes.

Input Parameters

string
required
Name of the album to be created in Google Photos. Maximum 500 characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_GET_ALBUMRetrieves a Google Photos album created by this app by its ID.

Input Parameters

string
required
Identifier of the album to be requested.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_GET_MEDIA_ITEM_DOWNLOADDownloads an app-created Google Photos media item and returns it as a file.

Input Parameters

string
required
ID of the media item to download

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_LIST_ALBUMSLists Google Photos albums created by this app, with pagination support.

Input Parameters

integer
Maximum number of albums to return. Default 20, maximum 50.
string
Continuation token for getting the next page of results
boolean
If true, excludes media items not created by this app

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_LIST_MEDIA_ITEMSLists 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

integer
Maximum number of items to return. Default 25, maximum 100.
string
Token for getting the next page of results

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_LIST_SHARED_ALBUMSLists 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

integer
Maximum number of albums to return. Default 20, maximum 50.
string
Continuation token for getting the next page of results. Use the value returned in nextPageToken from the previous response.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_SEARCH_MEDIA_ITEMSSearches for app-created media items in a user’s Google Photos library.

Input Parameters

string
Album to search within
object
Search filters
string
Sort order for results, e.g. ‘MediaMetadata.creation_time desc’
integer
Maximum number of items to return. Default 25, maximum 100.
string
Token for getting the next page

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_UPDATE_ALBUMUpdates the title or cover photo of a Google Photos album created by this app.

Input Parameters

string
New title for the album. Maximum 500 characters.
string
required
Identifier of the album to update
string
ID of the media item to use as album cover photo

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_UPDATE_MEDIA_ITEMUpdates the description of an app-created media item in Google Photos.

Input Parameters

string
required
New description for the media item. Must be shorter than 1000 characters.
string
required
Identifier of the media item to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: GOOGLEPHOTOS_UPLOAD_MEDIAUpload 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

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.).
string
File name for the uploaded media. Required when using ‘url’ parameter. Should include the file extension (e.g., ‘photo.jpg’, ‘video.mp4’).
string
Optional description for the media item
object
The media file to upload to Google Photos.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not