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)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "smugmug-create-album",
"configured_props": {
"smugmug": { "authProvisionId": "apn_xxxxxxx" },
"folder": "Folder",
"title": "Title"
}
}'// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "smugmug",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
name: "smugmug-create-album",
arguments: {
folder: "Folder",
title: "Title",
},
})SCHEMA
Inputs
Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.
| 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
- Source
- View on GitHub ↗