# SmugMug

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

- **Category:** images & design
- **Auth:** API_KEY
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `SMUGMUG`
- **Version:** 20260211_00

## Tools

### 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.

### Get Node Details

**Slug:** `SMUGMUG_GET_NODE_DETAILS`

This tool retrieves the details for a specific node (e.g., Album, Folder, Page) using its unique NodeID. It uses the API endpoint GET /api/v2/node/{NodeID} to fetch details such as Uri, NodeID, Name, Type, and UrlPath.

### 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.

### List Albums in Folder

**Slug:** `SMUGMUG_LIST_ALBUMS_IN_FOLDER`

Lists all albums within a specified folder on SmugMug. This tool retrieves child albums from a given folder node. Note that folders can contain both albums and sub-folders - this action filters to return only albums, not sub-folders. If a folder contains no albums (only sub-folders), the ChildNodes list will be empty. Use the 'start' and 'count' parameters for pagination when dealing with folders containing many albums. The response includes pagination info (Total, NextPage, etc.) to help navigate. To find folder NodeIDs, use SMUGMUG_LIST_CHILD_NODES or SMUGMUG_GET_NODE_DETAILS first.

### 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.
