Automate Pinterest with AI Agents

Create pins, target boards, add destination links, and control visual branding with dominant colors — all from the command line or through your AI agent.

Setup Guide ClawHub

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

Pin to Pinterest in Seconds

Terminal

# Install globally
npm install -g postiz

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Find your Pinterest integration
postiz integrations:list

# Upload an image
IMAGE=$(postiz upload design.jpg)
IMAGE_URL=$(echo "$IMAGE" | jq -r '.path')

# Create a Pinterest pin
postiz posts:create \
  -c "Beautiful home office setup ideas for remote workers" \
  -m "$IMAGE_URL" \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"board":"board-id","title":"Home Office Ideas","link":"https://example.com/home-office"}' \
  -i "your-pinterest-integration-id"

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

Upload high-quality images directly via the CLI. 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 It Works

Find Your Pinterest Integration

List your connected accounts and grab your Pinterest integration ID. You can also fetch available settings to see what options are supported.

Discovery

# List all integrations
postiz integrations:list

# Filter for Pinterest
postiz integrations:list | jq \
  '.[] | select(.identifier=="pinterest")'

# Get Pinterest settings schema
postiz integrations:settings <pinterest-id>

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.

Upload

# Upload image and extract URL
RESULT=$(postiz upload design.jpg)
IMAGE_URL=$(echo "$RESULT" | jq -r '.path')

echo $IMAGE_URL
# https://uploads.postiz.com/your-image.jpg

Create Your Pin

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

Pin Creation

postiz posts:create \
  -c "Inspiring workspace design tips" \
  -m "$IMAGE_URL" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "board": "your-board-id",
    "title": "Workspace Design Tips",
    "link": "https://example.com/tips",
    "dominant_color": "#682EE1"
  }' \
  -i "pinterest-id"

Pinterest Settings Reference

Every Pinterest pin accepts these platform-specific settings via the --settings flag.

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

Copy-paste these settings for common Pinterest pinning scenarios.

Simple Pin with Link

settings.json

{
  "board": "home-decor-board-id",
  "title": "10 Modern Living Room Ideas",
  "link": "https://example.com/living-room-ideas"
}

Branded Pin with Color

settings.json

{
  "board": "brand-pins-board-id",
  "title": "New Product Launch",
  "link": "https://example.com/product",
  "dominant_color": "#FF6B35"
}

Minimal Pin (Board Only)

settings.json

{
  "board": "inspiration-board-id"
}

Blog Post Pin

settings.json

{
  "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 OpenClaw?

OpenClaw is the open-source personal AI agent with 145k+ GitHub stars. It runs locally on your machine, connects through apps you already use, and takes real actions on your behalf.

💬

Works Where You Are

Message OpenClaw from WhatsApp, Telegram, Slack, Discord, Signal, iMessage, or 10+ other platforms. No new app to learn.

🧩

Skill-Based Architecture

OpenClaw extends its abilities through Skills — lightweight plugins defined in Markdown files. Postiz is available as a skill on ClawHub.

⏰

Proactive Automation

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

How Postiz Becomes an OpenClaw Skill

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

✓Install from ClawHub with one command: clawhub install nevo-david/postiz
✓OpenClaw reads the SKILL.md and learns all Postiz commands
✓Eligibility is checked automatically — POSTIZ_API_KEY must be set
✓Skills are loaded on-demand, keeping the agent context clean
✓Works with any LLM backend: Claude, GPT, Gemini, Llama, and more

Install from ClawHub

# Install the Postiz skill
clawhub install nevo-david/postiz

# Or install the CLI globally
npm install -g postiz

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Verify OpenClaw sees it
openclaw skills list --eligible

# Output:
# - postiz: Social media automation
#   CLI for scheduling posts
#   across 30+ platforms

Pinterest Pinning with OpenClaw

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

🦀

From Any Chat App

WhatsApp, Telegram, Slack, Discord...

Send a message to OpenClaw from your favorite chat app. It runs as a persistent daemon on your machine, so it picks up your message, discovers your Pinterest account via Postiz, uploads the image, and creates the pin — all while you go about your day.

WhatsApp / Telegram

You: Pin my product-shot.jpg to my
  "New Arrivals" board with a link to
  our shop page, schedule for tomorrow

OpenClaw: Got it! Here's what I'll do:
  1. Upload product-shot.jpg to Postiz
  2. Pin to "New Arrivals" board
  3. Link to your shop page
  4. Schedule for 2025-03-02T09:00:00Z

  Done! Your Pinterest pin is scheduled.
  Post ID: abc-123

🦀

Scheduled & Proactive

Cron jobs for recurring content

OpenClaw supports cron-based heartbeat tasks. Set up a recurring job that checks a folder for new images and pins them to Pinterest automatically — no manual trigger needed.

openclaw.json (heartbeat)

{
  "heartbeat": [
    {
      "cron": "0 10 * * 1,3,5",
      "prompt": "Check ~/designs/pinterest
  for new image files. For each one,
  upload to Postiz and create a pin
  on the 'Product Showcase' board.
  Use the filename as the title,
  link to our website. Set brand
  color #682EE1. Move pinned files
  to ~/designs/pinterest/posted."
    }
  ]
}

Why OpenClaw + Postiz for Pinterest

OpenClaw's skill system makes Postiz a natural fit. The agent reads the SKILL.md to understand every available command, then autonomously chains them together for Pinterest workflows.

✓Message from WhatsApp to create a Pinterest pin — no terminal needed
✓Cron jobs for hands-free pinning schedules three times a week
✓Structured JSON output lets OpenClaw verify each step succeeded
✓Board selection and link attachment handled automatically
✓Cross-post to Pinterest + other platforms in a single conversation
✓Model-agnostic — works with Claude, GPT, Gemini, or open-source LLMs

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Pinterest
metadata:
  openclaw:
    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 Agent works as a CLI tool with any AI agent that can execute shell commands — including Anthropic's Claude Code.

Claude Code

by Anthropic

Claude reads the SKILL.md file to learn all available Postiz commands, 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 will automatically run:
  postiz integrations:list
  postiz upload ./product-image.jpg
  postiz posts:create \
    -c "New spring collection!" \
    -m "uploaded-image-url" \
    -s "2025-03-02T09:00:00Z" \
    --settings '{"board":
      "spring-collection-id",
      "title":"Spring Collection",
      "link":"https://shop.example.com
        /spring",
      "dominant_color":"#682EE1"}' \
    -i "pinterest-id"

Pinterest + Other Platforms

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

Terminal

# Pin to Pinterest and post to Instagram simultaneously
postiz posts:create \
  -c "Check out our latest design! #design #inspiration" \
  -m "$IMAGE_URL" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "board": "design-inspiration-id",
    "title": "Latest Design Showcase",
    "link": "https://example.com/designs",
    "dominant_color": "#682EE1"
  }' \
  -i "pinterest-id,instagram-id"

# Batch schedule a week of Pinterest pins
for day in 1 2 3 4 5; do
  postiz posts:create \
    -c "Design tip #$day for the week" \
    -m "tip${day}-image-url" \
    -s "2025-03-0${day}T10:00:00Z" \
    --settings '{"board":"design-tips-id","title":"Design Tip '$day'","link":"https://example.com/tips/'$day'"}' \
    -i "pinterest-id"
done