# SmugMug AI integration on Definable > SmugMug is a platform for photographers to showcase, share, and sell their photos and videos. ## What this connects SmugMug is a platform for photographers to showcase, share, and sell their photos and videos. Vendor: https://www.smugmug.com/ ## Tools available **25** tools available. First 12: - `SMUGMUG_GET_ALBUM` — 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. - `SMUGMUG_GET_ALBUM_HIGHLIGHT_IMAGE` — 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. - `SMUGMUG_GET_ALBUM_IMAGE` — 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. - `SMUGMUG_GET_ALBUM_IMAGES` — 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.). - `SMUGMUG_GET_FOLDER_ALBUMS` — 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. - `SMUGMUG_GET_FOLDER_BY_USER_PATH` — Get Folder by User and 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. - `SMUGMUG_GET_FOLDER_DETAILS` — 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. - `SMUGMUG_GET_FOLDER_SUBFOLDERS` — 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. - `SMUGMUG_GET_IMAGE` — 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. - `SMUGMUG_GET_IMAGE_METADATA` — 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. - `SMUGMUG_GET_IMAGE_SIZE_DETAILS` — 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. - `SMUGMUG_GET_IMAGE_SIZES` — 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.). ## Auth Auth schemes: `API_KEY`. ## How agents use SmugMug Inside a Definable workflow, SmugMug is one of the tools the **Distributor specialist** can call. Example coordination patterns: - **Researcher → SmugMug** — the Researcher (GPT-5.5) pulls context from SmugMug (records, threads, documents), synthesises findings, and briefs the rest of the team. - **Writer → Distributor → SmugMug** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into SmugMug (create record, post message, draft email). - **Designer / Engineer → Distributor → SmugMug** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via SmugMug (attach file, open PR comment, post status). The Verifier checks every SmugMug call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention. ## Categories - images & design — https://definable.ai/apps/category/images-&-design/ - file management & storage — https://definable.ai/apps/category/file-management-&-storage/ ## Related - HTML page: https://definable.ai/apps/smugmug/ - Same category (images & design): https://definable.ai/apps/category/images-&-design/ - All integrations: https://definable.ai/apps/ - Workflow (multi-agent loop): https://definable.ai/workflow/ - Apps llms.txt index: https://definable.ai/llms-apps.txt