View as Markdown
SmugMug icon

SmugMug ACTION

Create Album

Creates an album. See the docs here
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's SmugMug account once, then configure and run Create Album from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "smugmug-create-album",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    smugmug: { authProvisionId: "apn_xxxxxxx" },
    folder: "Folder",
    title: "Title",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Album inputs
Property Type Description
folder Folder string
Folder where the new album will be created
Required Dynamic
title Title string
The human-readable title.
Required
niceName Nice Name string
The user-configurable component of the album's webUri. Must begin with a capital letter.
Required
urlName URL Name string
The user-configurable component of the album's webUri.
Optional
privacy Privacy string
Private is not supported on legacy accounts. It can be Private, Unlisted, or Public.
Optional
printmarkUri Printmark URI string
Uri of an image to use in print orders of your photos, usually, a team, company logo, your signature.
Optional
watermarkUri Watermark URI string
Uri of an image to be applied on your photos as a watermark for protection.
Optional
themeUri Theme URI string
Only applies to legacy accounts.
Optional
templateUri Template URI string
Uri of template, preset settings to be applied on the album.
Optional
allowDownloads Allow Downloads boolean
Allow downloads of this album?
Optional
backprinting Backprinting string
Text to appear in the back of print orders of your photos.
Optional
boutiquePackaging Boutique Packaging string
Is this album available for Boutique Packaging in your customers orders?
Optional
canRank Can Rank boolean
Enable Canrank property of the album.
Optional
clean Clean boolean
Enable Clean property of the album.
Optional
comments Comments boolean
Allow other users leave comments in the album?
Optional
description Description string
The human-readable description
Optional
downloadPassword Download Password string
The password used for protecting album download.
Optional
EXIF EXIF string
Display a photo's EXIF information.
Optional
familyEdit Family Edit boolean
Enable FamilyEdit property of the album.
Optional
filenames Filenames boolean
Enable Filenames property of the album.
Optional
friendEdit Friend Edit string
Allow this album available for granting special privileges to friends and family with an Smugmug account?
Optional
geography Geography boolean
Enable Geography property of the album.
Optional
header Header string
Use a customer header for the album appearance?
Optional
hideOwner Hide Owner boolean
Hide owner information from the album?
Optional
interceptShipping Intercept Shipping string
Personal Delivery.
Optional
keywords Keywords string
A semicolon-separated list of keywords.
Optional
largestSize Largest Size string
Largest display sizes for images in the album.
Optional
packagingBranding Packaging Branding boolean
Enable PackagingBranding property of the album.
Optional
password Password string
The password used for protecting album access.
Optional
passwordHint Password Hint string
The hint for the album-access password.
Optional
printable Printable string
Allow images of this album to be available for printing?
Optional
proofDays Proof Days string
A proof-delay between 1 and 7 business days for customer orders.
Optional
protected Protected boolean
Enable right-click protection?
Optional
share Share boolean
Allow this album to be shared?
Optional
slideshow Slideshow boolean
Enable the slideshow content block on this album?
Optional
sortDirection Sort Direction string
Specifies the direction in which to sort album images.
Optional
sortMethod Sort Method string
Album's image property to use for sorting?
Optional
squareThumbs Square Thumbs boolean
Enable thumbnails in album's images (only available in SmugMug style).
Optional
uploadKey Upload Key string
A key for your guests to upload images to the album.
Optional
watermark Watermark boolean
Automatically apply watermark to uploaded images?
Optional
worldSearchable World Searchable string
Allow this album to appear in external search results? Can be "No" or "Inherit from User".
Optional
autoRename Auto Rename boolean
Auto-rename conflicting album NiceNames?
Optional
securityType SecurityType string
Access protection method for the folder.
Optional
highlightAlbumImageUri Highlight Album Image URI string
Uri of an image which can be used as a representative of the entire album.
Optional
albumTemplateUri Album Template URI string
Specify default album presets by providing an AlbumTemplateUri.
Optional
smugSearchable Smug Searchable string
Allow this album to appear in SmugMug search results? Can be "No" or "Inherit from User".
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
smugmug-create-album
Version
2.0.2
App
SmugMug
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes