# SmugMug

SmugMug is a platform for photographers to showcase, share, and sell their photos and videos.

- **Category:** images & design
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 27
- **Triggers:** 0
- **Slug:** `SMUGMUG`
- **Version:** 20260312_00

## Tools

### Get Album

**Slug:** `SMUGMUG_GET_ALBUM`

Retrieves detailed information about a SmugMug album using its album key. Returns album settings, metadata, image count, and links to related resources like images and user info. Use this to get comprehensive details about a specific album/gallery.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `album_key` | string | Yes | The unique album key that identifies the album on SmugMug. This is typically a 6-character alphanumeric string (e.g., 'SJT3DX'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Album Highlight Image

**Slug:** `SMUGMUG_GET_ALBUM_HIGHLIGHT_IMAGE`

Retrieves the highlight/cover image for a SmugMug album. Returns detailed information about the album's cover image including dimensions, URLs, and metadata. Use this when you need to get the featured image for an album.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `album_key` | string | Yes | The unique album key (6-7 character alphanumeric string) that identifies the album. This is different from NodeID - it's the album's specific key identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Album Image

**Slug:** `SMUGMUG_GET_ALBUM_IMAGE`

Get an image within a specific album context as an AlbumImage relationship object. Returns detailed information about the image including metadata, dimensions, URLs, and relationships. Use this when you need to retrieve a specific image from an album with full album context.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `album_key` | string | Yes | The unique album key that identifies the album. This is a 6-7 character alphanumeric string (e.g., 'SJT3DX'). |
| `image_key` | string | Yes | The unique image key that identifies the image. This is typically a 7-8 character alphanumeric string (e.g., 'jPPKD2c'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Album Images

**Slug:** `SMUGMUG_GET_ALBUM_IMAGES`

Tool to retrieve all images in a SmugMug album as AlbumImage relationship objects. Use this action when you need to list or access images within a specific album. An AlbumImage represents the relationship between an album and an image, which is useful because the same image may appear in multiple albums. The response includes image metadata, URIs for different sizes, and pagination support for large albums. Returns AlbumImage objects with fields like ImageKey, Title, Caption, WebUri, ArchivedUri, and nested Uris for accessing related resources (ImageSizes, LargestImage, etc.).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | The number of images to retrieve per page. Default is typically 10 if not specified. Use with 'start' for pagination through large albums. |
| `start` | integer | No | The starting index for pagination (1-indexed). Use this with 'count' to paginate through large result sets when an album contains many images. |
| `album_key` | string | Yes | The unique key identifier for the album. This is a unique string that identifies the album (e.g., 'SJT3DX'). You can obtain album keys from SMUGMUG_LIST_ALBUMS_IN_FOLDER or other album listing actions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Folder Albums

**Slug:** `SMUGMUG_GET_FOLDER_ALBUMS`

Tool to retrieve albums from a specific folder in a SmugMug user's account by nickname and folder path. Use when you need to list albums in a folder using the user's nickname and folder path rather than NodeID. This is particularly useful when you know the folder structure but don't have the NodeID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | No | The folder path within the user's account (e.g., 'SmugMug' or 'SmugMug/Heroes'). Use '/' to separate nested folders. Omit this parameter or pass empty string to get albums from the root folder. |
| `FolderID` | string | No | Optional folder ID filter parameter to narrow results. This is typically a 5-character alphanumeric string. |
| `nickname` | string | Yes | The SmugMug user's nickname/username whose folder to retrieve albums from. This is the user's unique identifier on SmugMug (e.g., 'cmac', 'baldy'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Folder by User and Path

**Slug:** `SMUGMUG_GET_FOLDER_BY_USER_PATH`

Tool to retrieve folder details by user nickname and folder path. Use when you need to access a specific folder within a user's SmugMug account using the hierarchical path structure. Note: For New SmugMug, use the Node endpoint (SMUGMUG_GET_NODE_DETAILS) instead.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `nickname` | string | Yes | The user's SmugMug nickname (username). This identifies which user's folder structure to access. |
| `folder_path` | string | Yes | The path to the folder within the user's account. Use forward slashes (/) to separate nested folders (e.g., 'SmugMug' or 'Travel/2024'). For the root folder, use an empty string. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Folder Details

**Slug:** `SMUGMUG_GET_FOLDER_DETAILS`

Retrieves details of a specific folder in SmugMug using its Node ID. Returns folder metadata including name, description, URL path, creation and modification dates, node ID, and optionally the URI of the album set as the highlight image for the folder. Note: This action only works with Folder-type nodes. If a non-folder node ID (e.g., Album) is provided, an error will be raised. Use SMUGMUG_GET_NODE_DETAILS for general node information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `node_id` | string | Yes | The unique SmugMug Node ID of the folder to retrieve details for. This is typically a 5-character alphanumeric string (e.g., 'c4jv4'). You can obtain node IDs from the SMUGMUG_LIST_CHILD_NODES action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Folder Subfolders

**Slug:** `SMUGMUG_GET_FOLDER_SUBFOLDERS`

Retrieves all subfolders within a specified folder in a SmugMug user's account. Use this action to navigate the folder hierarchy by fetching direct child folders of a given parent folder. Specify the user's nickname and the folder path (use empty string or omit for root-level folders). Returns folder metadata including names, URLs, security settings, and IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `path` | string | No | The folder path within the user's account. Use '/' separator for nested folders (e.g., 'SmugMug/Heroes'). Leave empty or omit for root-level subfolders. |
| `nickname` | string | Yes | The SmugMug user's nickname/username. This identifies the account whose folder structure you're accessing. |
| `folder_id` | string | No | Optional folder ID parameter for additional filtering. Must be at least 5 characters if provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Image

**Slug:** `SMUGMUG_GET_IMAGE`

Tool to retrieve details for a specific image (photo or video) by its image key. Returns comprehensive image metadata including dimensions, upload dates, geolocation, and links to related resources like sizes, metadata, and comments. Use when you need detailed information about a specific photo or video in SmugMug.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image_key` | string | Yes | The unique image key identifier (e.g., 'jPPKD2c-1'). This is the key that identifies a specific photo or video in SmugMug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Image Metadata

**Slug:** `SMUGMUG_GET_IMAGE_METADATA`

Tool to retrieve additional metadata from an image file including EXIF data, camera settings, GPS location, and other embedded information. Use when you need detailed technical information about an image, such as camera make/model, exposure settings, GPS coordinates, or timestamps.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image_key` | string | Yes | The unique key identifier for the image. This is the image's unique identifier on SmugMug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Image Size Details

**Slug:** `SMUGMUG_GET_IMAGE_SIZE_DETAILS`

Retrieve raw media URLs and dimensions for all available sizes of an image. Returns detailed information including direct download URLs, dimensions, and file sizes for each variant. Use this when you need to download photos or videos with specific size requirements.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image_key` | string | Yes | The unique key identifier for the image. This is typically a short alphanumeric string (e.g., 'fRmtKwv-0'). You can obtain this from image listings or album contents. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Image Sizes

**Slug:** `SMUGMUG_GET_IMAGE_SIZES`

Retrieves available image sizes and URLs for a SmugMug image by its unique image key. Use this to get download URLs for different resolutions (tiny, thumb, small, medium, large, xlarge, original, etc.).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image_key` | string | Yes | The unique alphanumeric identifier for the image (e.g., 'jPPKD2c-1'). This key is returned from album image listings or image creation endpoints. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Node Highlight Image

**Slug:** `SMUGMUG_GET_NODE_HIGHLIGHT_IMAGE`

Tool to get the highlight/cover image for a node (folder, album, or page). Use when you need to retrieve the representative image set for a SmugMug node.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `node_id` | string | Yes | The unique identifier for the node (folder, album, or page) to get the highlight/cover image for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Node Parent

**Slug:** `SMUGMUG_GET_NODE_PARENT`

Tool to retrieve the parent node of a specified SmugMug node. Use when navigating up the folder hierarchy or determining a node's location within the organizational structure.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `node_id` | string | Yes | The unique identifier for the node whose parent you want to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Node Parents

**Slug:** `SMUGMUG_GET_NODE_PARENTS`

Tool to retrieve a node and all its ancestor nodes (breadcrumb trail). Use when you need to understand the full hierarchy path from a node to the root.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `node_id` | string | Yes | The unique identifier of the node to retrieve parent breadcrumb trail for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User

**Slug:** `SMUGMUG_GET_USER`

Tool to get a SmugMug user account by their nickname. Returns user details including display name, view pass hint, and links to related resources like albums, profile, and images. Use when you need to fetch basic information about a SmugMug user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `nickname` | string | Yes | The user's nickname/username on SmugMug. This is the unique identifier used in the user's SmugMug URL. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Bio Image

**Slug:** `SMUGMUG_GET_USER_BIO_IMAGE`

Tool to retrieve the bio image for a SmugMug user by their nickname (username). Use when you need to get information about a user's bio/profile image including image metadata, dimensions, URLs, and related resource URIs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `nickname` | string | Yes | The nickname of the SmugMug user whose bio image should be retrieved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Featured Albums

**Slug:** `SMUGMUG_GET_USER_FEATURED_ALBUMS`

Retrieves the featured albums for a SmugMug user by their nickname. Use this when you need to see which albums a user has highlighted as featured content on their profile.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `nickname` | string | Yes | The nickname of the SmugMug user whose featured albums you want to retrieve. This is the user's unique identifier on SmugMug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Features

**Slug:** `SMUGMUG_GET_USER_FEATURES`

Tool to retrieve a list of features available to a SmugMug user based on their subscription plan. Use when you need to check what capabilities or features a specific user has access to on SmugMug.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `nickname` | string | Yes | The user's nickname (username) on SmugMug. This is the unique identifier used to retrieve the user's available features. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Profile

**Slug:** `SMUGMUG_GET_USER_PROFILE`

Retrieves the public profile information for a SmugMug user by their nickname (username). Returns profile details including name, bio, contact email, and social media links. Use this to get information about a SmugMug photographer or user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `nick_name` | string | Yes | The NickName (username) of the SmugMug user to retrieve the profile for. This is the user's unique identifier on SmugMug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Root Node

**Slug:** `SMUGMUG_GET_USER_ROOT_NODE`

Tool to retrieve the root node of a user's folder tree on SmugMug. Use when you need to navigate a user's gallery structure or find the starting point of their folder hierarchy.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `nickname` | string | Yes | The SmugMug user's nickname/username. This is the unique identifier for the user whose root folder node you want to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Child Nodes

**Slug:** `SMUGMUG_LIST_CHILD_NODES`

Lists all child nodes (folders and albums) under a specified parent node in SmugMug. Use this action to navigate SmugMug's folder/album hierarchy. Start from a user's root node (obtained from user profile) and traverse down through folders to find albums. Returns child nodes with their NodeID, Type, Name, and WebUri. Use the NodeID from results to fetch further nested children or to get detailed node information.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Number of child nodes to retrieve per page. Defaults to 10. Maximum is 100. |
| `start` | integer | No | The 1-based starting index for pagination. Defaults to 1 (first page). |
| `node_id` | string | Yes | The unique NodeID of the parent node. You can get this from user profile (root node), node details, or previous list child nodes responses. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search User Content

**Slug:** `SMUGMUG_SEARCH_USER_CONTENT`

Search for images across a user's SmugMug content. This tool searches through a user's images by querying titles, captions, keywords, and filenames. Returns a list of matching images with details like title, caption, URLs, and related resources. Use this when you need to find specific images within a user's SmugMug account. Results are returned in paginated format with up to 100 images per page. The default ordering is by popularity, but can be changed to newest or oldest.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `q` | string | Yes | Search query text to find in the user's images. The search looks for matches in image titles, captions, keywords, and filenames. Maximum 100 characters. |
| `Order` | string ("Popular" | "Oldest" | "Newest") | No | Order for search results. |
| `nickname` | string | Yes | The SmugMug user's nickname whose content to search. This is the unique username on SmugMug. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unlock Album

**Slug:** `SMUGMUG_UNLOCK_ALBUM`

Tool to unlock a password-protected SmugMug album. Use when you need to access content in a locked album. Only available for albums that are currently password-protected.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `Password` | string | Yes | The password required to unlock the album. Must match the album's configured password. |
| `album_key` | string | Yes | The album's unique key (e.g., 'GxmcTJ'). This identifies the password-protected album to unlock. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unlock User Site

**Slug:** `SMUGMUG_UNLOCK_USER`

Tool to unlock a user's password-protected SmugMug site. Use when you need to access a locked user's site content. This action is only available if the user's site is currently locked with a password.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `nickname` | string | Yes | The user's nickname (username) whose site should be unlocked. This is the SmugMug user identifier. |
| `password` | string | Yes | The site password required to unlock the user's password-protected site. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |