Pin to Pinterest from Paperclip

Paperclip agents can create and schedule Pinterest pins through Postiz. Install the Postiz skill where the agent runs, connect your Pinterest account in Postiz, and the agent can upload the pin image, choose the board, write the title and description, attach a destination link, and set a dominant color for consistent branding.

Setup Guide Paperclip

Please make sure there is always a human in the loop.

Last updated: September 2026

Pin to Pinterest in Seconds

Setup, then just ask

# One-time setup
npx skills add gitroomhq/postiz-agent
export POSTIZ_API_KEY=your_api_key

# Then just ask Paperclip:
> Create a pin on my "Design" board
  linking to our blog post

Paperclip: Done! Your Pinterest post is scheduled.

Pinterest-Specific Features

📌

Pin Creation

Create rich pins with images, descriptions, titles, and destination links. Drive traffic from Pinterest to your website.

📋

Board Targeting

Pin directly to specific boards. Organize your content by topic, campaign, or audience segment for maximum reach.

🔗

Link Pins

Attach destination URLs to your pins. Every click drives traffic directly to your website, product page, or blog.

🎨

Visual Branding

Set a dominant color for your pins to maintain brand consistency. Control how your content looks in Pinterest feeds.

🖼

Image Uploads

Hand Paperclip an image and it uploads it. Supports JPG, PNG, WEBP, and other common image formats.

📅

Scheduled Pinning

Schedule pins for optimal times when your audience is most active. Build a consistent pinning cadence automatically.

How does Paperclip post to Pinterest?

You describe what you want in plain language and Paperclip handles the Postiz calls for you. Here is how a typical conversation goes.

Find Your Pinterest Integration

Ask Paperclip whether your Pinterest account is connected. It also checks which options the platform supports.

Example conversation

> Is my Pinterest account connected to Postiz?

Paperclip: Yes — your Pinterest account is connected
  and ready. Want me to post something?

Upload Your Image

Upload your pin image to get a public URL. Pinterest requires high-quality images for best results. Supports JPG, PNG, WEBP, and more.

Example conversation

> Draft a Pinterest post about our new
  feature launch

Paperclip: Here's a draft for Pinterest:
  "We just shipped something big..."
  Want me to add media and schedule it?

Create Your Pin

Schedule a Pinterest pin with your image, description, board, title, destination link, and optional dominant color for brand consistency.

Example conversation

> Yes — add screenshot.png and schedule
  it for tomorrow at 9am

Paperclip: Done! Scheduled on Pinterest for
  tomorrow at 9:00 AM.

Pinterest Settings Reference

Mention any of these in plain language and Paperclip sets them for you. These are the options every Pinterest pin can carry.

Field	Type	Required	Description
`__type`	string	Yes	Must be "pinterest"
`board`	string	Yes	Board ID to pin to
`title`	string	No	Pin title (max 100 characters)
`link`	string	No	Destination URL when the pin is clicked
`dominant_color`	string	No	Hex color code for visual branding (e.g. "#FF6B35")

Common Configurations

Ask Paperclip for any of these common Pinterest pinning scenarios and it applies the matching settings.

Simple Pin with Link

Just ask

> Post it with: Simple Pin with Link

Paperclip: Got it. Applying:
  board: home-decor-board-id
  title: 10 Modern Living Room Ideas
  link: https://example.com/living-room-ideas

Branded Pin with Color

Just ask

> Post it with: Branded Pin with Color

Paperclip: Got it. Applying:
  board: brand-pins-board-id
  title: New Product Launch
  link: https://example.com/product
  dominant_color: #FF6B35

Minimal Pin (Board Only)

Just ask

> Post it with: Minimal Pin (Board Only)

Paperclip: Got it. Applying:
  board: inspiration-board-id

Blog Post Pin

Just ask

> Post it with: Blog Post Pin

Paperclip: Got it. Applying:
  board: blog-posts-board-id
  title: How to Automate Social Media in 2025
  link: https://example.com/blog/automate-social-media
  dominant_color: #682EE1

What is Paperclip?

Paperclip is an open-source orchestration framework for building “zero-human companies” by hiring and managing teams of AI agents. It handles content, social media distribution, marketing, dev, QA, and more from a single dashboard.

👥

Agent Teams

Paperclip manages teams of AI agents that work together. Assign a content agent, a scheduling agent, and a review agent to your social media workflow.

📊

Single Dashboard

Monitor all your AI agents and their social media tasks from one unified dashboard. Track posts, schedules, and performance in real time.

⚙

Orchestration

Schedule recurring tasks with cron jobs. Paperclip can pin your Pinterest content on a schedule without you having to ask each time.

How Postiz Works with Paperclip

When you install Postiz Agent globally, Paperclip automatically discovers it by reading the bundled SKILL.md file. This file tells Paperclip what commands are available, what environment variables are needed, and how to compose Pinterest pins with the right settings.

✓Install Postiz Agent and set your POSTIZ_API_KEY
✓Paperclip discovers Postiz through tool integration
✓Assign Postiz commands to specialized agents in your team
✓Orchestrate multi-step workflows with approval chains
✓Monitor everything from the Paperclip dashboard

Install Postiz

# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Paperclip discovers Postiz through
# its tool integration system
# and assigns it to agent teams

Pinterest Pinning with Paperclip

Message Paperclip from any platform — it reads the Postiz skill, discovers your Pinterest integration, and handles the entire pinning workflow autonomously.

📎

From Any Chat App

Paperclip assigns specialized agents to ...

Assign a task to Paperclip from its dashboard. It runs as a long-lived service on your own infrastructure, so it picks up the task, discovers your Pinterest account via Postiz, uploads the image, and creates the pin — all while you go about your day.

Paperclip

Content Agent: Drafted a post about
  the feature launch for Pinterest.

Review Agent: Approved with minor
  edits. Ready to publish.

Scheduling Agent: Found Pinterest
  integration via Postiz.
  Scheduled for tomorrow 9:00 AM.

  Post ID: abc-123
  Status: Scheduled

📎

Scheduled & Proactive

Paperclip orchestrates recurring co...

Paperclip supports scheduled heartbeats. Set up a recurring job that checks a folder for new images and pins them to Pinterest automatically — no manual trigger needed.

paperclip.yaml (pipeline)

pipelines:
  daily_social:
    schedule: "0 9 * * 1-5"
    agents:
      - role: content_creator
        task: "Draft a Pinterest post
          about trending industry topics"
      - role: reviewer
        task: "Review and polish the
          draft for engagement"
      - role: publisher
        task: "Schedule via Postiz
          for today at noon"

Why Paperclip + Postiz for Pinterest

Paperclip makes Postiz a natural fit for your Pinterest workflow. The agent discovers all available commands and autonomously chains them together.

✓Multi-agent teams for quality Pinterest content — draft, review, publish
✓Single dashboard to monitor all social media automation
✓Orchestrated pipelines from content creation to publishing
✓Scheduled pipelines for hands-free daily posting
✓Cross-post to Pinterest + other platforms in a single pipeline
✓Open-source — fully customizable agent workflows

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Pinterest
metadata:
  paperclip:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Pinterest Settings
board (required), title,
link (destination URL),
dominant_color (hex branding)

Also Works with Claude Code

Postiz works with any AI agent that can run commands or call MCP tools — you ask, the agent does the work. That includes Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the Postiz skill so it knows what it can do, then autonomously discovers your Pinterest integration, uploads your image, selects the right board, and creates the pin with your link and branding.

Claude Code

> Pin my new product image to the
  "Spring Collection" board with a link
  to the product page, use brand color

Claude: Done! Scheduled on Pinterest for
  tomorrow at 9:00 AM.

Pinterest + Other Platforms

Schedule the same image to Pinterest and other platforms in a single request. Each platform gets its own settings.

Example

> Post "Excited to announce our new feature!" to
  Pinterest and LinkedIn tomorrow at 9am, then schedule
  a daily tip on Pinterest every weekday at 10am

Paperclip: Done! Scheduled:
  - Pinterest + LinkedIn: tomorrow 9:00 AM
  - Daily tips on Pinterest: Mon-Fri 10:00 AM

What can you ask Paperclip to do on Pinterest?

You assign a task in plain language and the agent translates it into Postiz calls with the right Pinterest settings. These are prompts people actually give a Paperclip agent for Pinterest.

Link pin to a board

Ask Paperclip

> Pin recipe-card.png to the "Weeknight Dinners"
  board, title "20-minute pasta", link to the
  recipe page, tomorrow 6pm

Paperclip: board resolved, link set. Scheduled on
  Pinterest for tomorrow 6:00 PM.

Batch of pins

Ask Paperclip

> Create one pin per image in ./pins for the
  Product Launch board, one per day at 11am

Paperclip: 8 pins queued, Mon-Mon 11:00 AM,
  titles taken from file names.

Brand color

Ask Paperclip

> Set the dominant color to #1F6FEB on all pins
  going out this week

Paperclip: dominant_color: #1F6FEB applied to
  the 5 scheduled pins.

What Pinterest rules should the agent follow?

Pinterest rejects posts that break its limits, so the agent needs these constraints up front. Put them in the task or in your Paperclip agent's instructions.

✓board is required. Ask the agent to list your boards first (postiz integrations:trigger) and it resolves the board ID from the name.
✓Every pin needs an image, uploaded through Postiz. Vertical 2:3 images (for example 1000 x 1500) display best.
✓Titles are limited to 100 characters and descriptions to 500. Put keywords in both, since Pinterest search reads them.
✓link is the click-through URL. dominant_color is a hex value shown while the image loads.

Paperclip and Pinterest: frequently asked questions

Short answers to the questions teams ask before letting a Paperclip agent post to Pinterest through Postiz.

How do I pin to Pinterest from Paperclip?

Install the Postiz skill in your agent's environment with npx skills add gitroomhq/postiz-agent, set POSTIZ_API_KEY, and connect your Pinterest account in Postiz. Then assign a task like "pin this image to the Recipes board tomorrow at 6pm" and the agent uploads the image and schedules the pin.

How does a Paperclip agent pick the Pinterest board?

Pinterest requires a board ID on every pin. The agent fetches your boards through Postiz, matches the name you gave ("Weeknight Dinners") to its ID, and sets the board field. If two boards have similar names it should ask you to confirm rather than guess.

Can Paperclip add a link to each Pinterest pin?

Yes. Include the destination URL in the task and the agent sets the link field. Clicking the pin sends people to that page, which is how Pinterest drives traffic. Pair each pin with a specific landing page rather than your homepage for better results.

What image size should the agent use for Pinterest?

Vertical images with a 2:3 ratio, such as 1000 by 1500 pixels, display best in the Pinterest feed. If a design agent in your Paperclip org creates the images, tell it that ratio up front. Postiz uploads JPG, PNG, and WEBP files.

Can Paperclip schedule a week of Pinterest pins at once?

Yes. Hand the agent a folder of images and a board, and ask for one pin per day. It uploads each file, writes titles from file names or a brief, and schedules them through Postiz. Paperclip's dashboard shows the whole batch as tasks you can approve or edit before publishing.