# Create Album — SmugMug

> Creates an album. See the docs here

- Key: `smugmug-create-album`
- Type: Action (Write)
- Version: 2.0.2
- App: SmugMug (`smugmug`) — https://pipedream.com/apps/smugmug.md
- This page (HTML): https://pipedream.com/apps/smugmug/actions/create-album
- Hints: open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/smugmug/actions/create-album/create-album.mjs

## Description

Creates an album. [See the docs here](https://api.smugmug.com/api/v2/doc/reference/album.html)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `folder` | `string` | Yes | Folder where the new album will be created Options are loaded from the connected account. |
| `title` | `string` | Yes | The human-readable title. |
| `niceName` | `string` | Yes | The user-configurable component of the album's webUri. Must begin with a capital letter. |
| `urlName` | `string` | No | The user-configurable component of the album's webUri. |
| `privacy` | `string` | No | Private is not supported on legacy accounts. It can be Private, Unlisted, or Public. |
| `printmarkUri` | `string` | No | Uri of an image to use in print orders of your photos, usually, a team, company logo, your signature. |
| `watermarkUri` | `string` | No | Uri of an image to be applied on your photos as a watermark for protection. |
| `themeUri` | `string` | No | Only applies to legacy accounts. |
| `templateUri` | `string` | No | Uri of template, preset settings to be applied on the album. |
| `allowDownloads` | `boolean` | No | Allow downloads of this album? |
| `backprinting` | `string` | No | Text to appear in the back of print orders of your photos. |
| `boutiquePackaging` | `string` | No | Is this album available for Boutique Packaging in your customers orders? |
| `canRank` | `boolean` | No | Enable Canrank property of the album. |
| `clean` | `boolean` | No | Enable Clean property of the album. |
| `comments` | `boolean` | No | Allow other users leave comments in the album? |
| `description` | `string` | No | The human-readable description |
| `downloadPassword` | `string` | No | The password used for protecting album download. |
| `EXIF` | `string` | No | Display a photo's EXIF information. |
| `familyEdit` | `boolean` | No | Enable FamilyEdit property of the album. |
| `filenames` | `boolean` | No | Enable Filenames property of the album. |
| `friendEdit` | `string` | No | Allow this album available for granting special privileges to friends and family with an Smugmug account? |
| `geography` | `boolean` | No | Enable Geography property of the album. |
| `header` | `string` | No | Use a customer header for the album appearance? |
| `hideOwner` | `boolean` | No | Hide owner information from the album? |
| `interceptShipping` | `string` | No | Personal Delivery. |
| `keywords` | `string` | No | A semicolon-separated list of keywords. |
| `largestSize` | `string` | No | Largest display sizes for images in the album. |
| `packagingBranding` | `boolean` | No | Enable PackagingBranding property of the album. |
| `password` | `string` | No | The password used for protecting album access. |
| `passwordHint` | `string` | No | The hint for the album-access password. |
| `printable` | `string` | No | Allow images of this album to be available for printing? |
| `proofDays` | `string` | No | A proof-delay between 1 and 7 business days for customer orders. |
| `protected` | `boolean` | No | Enable right-click protection? |
| `share` | `boolean` | No | Allow this album to be shared? |
| `slideshow` | `boolean` | No | Enable the slideshow content block on this album? |
| `sortDirection` | `string` | No | Specifies the direction in which to sort album images. |
| `sortMethod` | `string` | No | Album's image property to use for sorting? |
| `squareThumbs` | `boolean` | No | Enable thumbnails in album's images (only available in SmugMug style). |
| `uploadKey` | `string` | No | A key for your guests to upload images to the album. |
| `watermark` | `boolean` | No | Automatically apply watermark to uploaded images? |
| `worldSearchable` | `string` | No | Allow this album to appear in external search results? Can be "No" or "Inherit from User". |
| `autoRename` | `boolean` | No | Auto-rename conflicting album NiceNames? |
| `securityType` | `string` | No | Access protection method for the folder. |
| `highlightAlbumImageUri` | `string` | No | Uri of an image which can be used as a representative of the entire album. |
| `albumTemplateUri` | `string` | No | Specify default album presets by providing an AlbumTemplateUri. |
| `smugSearchable` | `string` | No | Allow this album to appear in SmugMug search results? Can be "No" or "Inherit from User". |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_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",
  },
})
```

**TypeScript**

```ts
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**

```bash
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"
    }
  }'
```

---

- App: https://pipedream.com/apps/smugmug.md · All apps: https://pipedream.com/apps