View as Markdown
Pinterest icon

Pinterest ACTION

Create a Pin

Create a Pin on a board or board section, See the docs
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Pinterest account once, then configure and run Create a Pin 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: "pinterest-create-pin",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    pinterest: { authProvisionId: "apn_xxxxxxx" },
    boardId: "Board ID",
    boardSectionId: "Board Section ID",
  },
})

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 a Pin inputs
Property Type Description
boardId Board ID string
An ID identifying the board
Required Dynamic
boardSectionId Board Section ID string
An ID identifying the board section
Optional Dynamic
title Title string
Title of the pin
Required
description Description string
Description of the pin
Optional
link Link string
Source link
Optional
altText Alt. Text string
Alt. text of the pin
Optional
media Media string
The media content of the pin, only images are supported currently, please provide an image url or an image file from /tmp. To upload a file to /tmp folder, please follow the doc here
Required

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
pinterest-create-pin
Version
0.1.1
App
Pinterest
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes