View as Markdown
Getty Images icon

Getty Images ACTION

Create Collection

Create a new image collection (board) in Getty Images. Provide a name and an optional description. Returns the created collection's ID and metadata. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Getty Images account once, then configure and run Create Collection 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: "getty_images-create-collection",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    getty_images: { authProvisionId: "apn_xxxxxxx" },
    collectionName: "Collection Name",
    collectionDescription: "Collection Description",
  },
})

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 Collection inputs
Property Type Description
collectionName Collection Name string
Name for the new image collection.
Required
collectionDescription Collection Description string
Optional description for the new image collection.
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
getty_images-create-collection
Version
0.0.1
App
Getty Images
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes