Connect AI agents to Pinterest. Agents publish image, carousel, and async video pins, organize boards and sections, repin curated content, search owned pins and boards, and pull account and per-pin analytics into reporting workflows.
What This Integration Enables
Pinterest is not a feed you post into, it is a visual search engine you stock, and pins keep earning discovery months after publication. That changes what disciplined operation means: consistent publishing cadence, boards organized the way searchers browse, and an analytics loop that tells the creative team what to make more of. FlowRunner agents run all three against the Pinterest API, from single image pins to the full video upload flow, while the operations that erase published content wait for a person. - Publish image and carousel pins from any content pipeline with titles, alt text, and destination links - Upload video pins end to end, including media registration, processing, and cover image - Keep boards and sections organized as collections launch and seasons turn - Repin curated content into campaign boards and search your own catalog of pins and boards - Pull account-level and per-pin analytics into reporting workflows
Without FlowRunner
With FlowRunner
Use Case Scenarios
From design tool to published pin without a download
Finished designs export from [Canva](/integrations/canva), and the agent publishes each with Create Pin, pointing the destination link at the matching product page and writing descriptive alt text from the design brief. Queued content in [Google Sheets](/integrations/google-sheets) drains the same way: each due row becomes a pin, and the returned pin id writes back to the row, turning the calendar into a publication log the whole team can audit.
The product video that becomes a pin while you do something else
A launch video is ready in FlowRunner file storage. Create Video Pin runs the entire Pinterest flow, registers the upload, transfers the bytes, waits out processing, then creates the pin with its cover image. For pipelines that need finer control, Register Media Upload and Get Media Upload Status expose the same machinery step by step. Either way, nobody babysits a progress bar, and the pin arrives with the destination link in place.
The monthly report that changes next month's creative
On the first of the month, the agent pulls Get User Account Analytics for the trailing period, broken down by pin format, and Get Pin Analytics for each pin in the current campaigns. The numbers land in the reporting sheet, and the digest posts to [Slack](/integrations/slack): which boards grew, which formats earned saves, which destination links drew clicks. The creative team stops guessing what Pinterest wants, because last month's pins already answered.
Human-in-Loop Highlight
Delete Board permanently deletes the board and every pin it contains, and it cannot be undone. A seasonal cleanup that misidentifies which board is stale does not remove some clutter, it erases months of published pins along with the search visibility they accumulated, distribution that took real time to earn and would take real time to earn again. So FlowRunner reorganization flows propose, and people dispose. The agent assembles the plan: "Board 'Holiday 2024', 84 pins per List Board Pins, no new saves this quarter per analytics. Recommend archiving pins to 'Seasonal Archive' via Update Pin, then deleting the empty board. Approve?" The channel owner approves the sequence, pins move first, and only an empty board gets deleted. The [human-in-the-loop](/concepts/human-in-the-loop) gate exists because published distribution is an asset, not clutter.
Agent Capabilities
24 actionsAccount and Analytics
3- Get User Account Retrieves the connected account's profile, type, and aggregate pin, board, and follower counts. The connection check that starts a workflow.
- Get User Account Analytics Retrieves account-level engagement and reach over a date range within the last 90 days, optionally split by pin format or content type. Requires a business account with Standard API access.
- Get Pin Analytics Retrieves daily and summary engagement metrics for a single pin over a date range, with optional device and app breakdowns. The per-asset half of the reporting loop.
Boards
5- List Boards Retrieves the account's boards with privacy filtering and bookmark pagination. The map of the account's structure.
- Get Board Retrieves one board's name, description, privacy, cover image, and pin and follower counts.
- Create Board Creates a board with a name and optional description and privacy. The step that gives a new collection a home.
- Update Board Updates a board's name, description, or privacy, changing only supplied fields.
- Delete Board Permanently deletes a board and every pin it contains. The operation this page's human gate exists for.
Sections
4- List Board Sections Retrieves a board's sections with pagination. The read behind organized curation.
- Create Board Section Creates a section within a board to group its pins.
- List Section Pins Retrieves the pins inside a specific section, paginated.
- Delete Board Section Removes a section while leaving its pins on the board, moved out rather than deleted.
Pins
9- Create Pin Creates an image pin from one or more public image URLs, a single URL for a standard pin, several for a carousel, with title, description, destination link, alt text, dominant color, and target section. The publishing workhorse.
- Get Pin Retrieves one pin's board, title, description, link, media, and creation time. The verification step after publishing.
- Update Pin Updates a pin's metadata or moves it to a different board or section. The tool behind restructures that preserve published content.
- Delete Pin Permanently deletes a single pin, with no undo. Used sparingly and deliberately.
- List Pins Retrieves the account's pins across all boards, with filters for native and promoted content.
- List Board Pins Retrieves the pins on a specific board, paginated. The inventory step before any board decision.
- Save Pin to Board Repins an existing pin to one of your boards, optionally into a section, copying the pin rather than creating new media. The curation move.
- Search My Pins Searches the account's own pins by keyword. The retrieval tool for large catalogs.
- Search My Boards Searches the account's own boards by keyword. The resolution step that keeps publishing flows aimed at the right board.
Video
3- Create Video Pin Creates a video pin end to end from a FlowRunner video file: registers the upload, transfers the bytes, waits for processing, and creates the pin with its required cover image URL.
- Register Media Upload Registers a video upload and returns the media id, upload URL, and signed parameters for the manual flow.
- Get Media Upload Status Retrieves a registered upload's processing status, registered, processing, succeeded, or failed, so a pin is only created against ready media.
Frequently Asked Questions
What can FlowRunner do with Pinterest?
FlowRunner agents can run Get User Account, Get User Account Analytics, and List Boards in Pinterest, plus 21 more actions.
Does connecting Pinterest to FlowRunner require OAuth?
Yes. Pinterest connects to FlowRunner with OAuth 2.0, so agents authenticate without handling raw credentials.
Can Pinterest trigger a FlowRunner workflow automatically?
Pinterest doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with Pinterest
$100 in credits. No card required. Connect in minutes.