NewGenerate AI UGC videos with your AI agent using agent-media

Post to Pinterest from Grok Bot

Grok Bot can create Pinterest pins through the Postiz plugin. Add the plugin to a Bot, store your Postiz API key as a secret, and name a board. The Bot uploads the image, sets the pin title, destination link, and dominant color, schedules the pin in Postiz, and can keep pinning on a routine from its cloud computer.

Setup Guide Marketplace

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

Last updated: September 2026

How to post to Pinterest from Grok Bot

Add the Postiz plugin once, then give your Bot an image and a board name. It uploads the image, sets the title and link, and schedules the pin.

Setup, then just ask

# One-time setup, in any Bot chat
/add-plugin postiz
# Store POSTIZ_API_KEY as a Bot secret when prompted

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

Grok Bot: Done! Your Pinterest post is scheduled.

What can Grok Bot do on Pinterest?

📌

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 Grok Bot 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 Grok Bot post to Pinterest?

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

Find Your Pinterest Integration

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

Example conversation

> Is my Pinterest account connected to Postiz?

Grok Bot: 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

Grok Bot: 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

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

Pinterest Settings Reference

Mention any of these in plain language and Grok Bot 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 Pinterest configurations

Ask Grok Bot 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

Grok Bot: 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

Grok Bot: 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)

Grok Bot: Got it. Applying:
  board: inspiration-board-id

Blog Post Pin

Just ask

> Post it with: Blog Post Pin

Grok Bot: 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 Grok Bot?

Grok Bot is the always-on AI teammate product from xAI and Cursor. You create named Bots, give each one a job, and they work 24/7 on their own persistent cloud computer — with a browser, a filesystem, and a terminal — pinging you only when they need approval.

Grok Bot is not the Grok chatbot. Grok is the assistant you chat with on X and grok.com. Grok Bot is a separate app for delegating real, multi-step work — like running your Pinterest presence with Postiz.

💻

Own Cloud Computer

Every Bot gets a persistent cloud machine with a terminal. Postiz runs there, so your Pinterest posts go out even when your laptop is closed.

🔁

Routines

Turn any task into a routine that runs on a schedule. Your Bot drafts, schedules, and reports on Pinterest content without being asked twice.

🛡️

Approvals Built In

Bots ask before changing external systems. Review the Pinterest posts your Bot prepared in Postiz, approve, and it publishes.

How Postiz Works with Grok Bot

Postiz is listed on the Grok Bot plugin marketplace. Add it to a Bot and the Postiz skill, CLI, and command reference are installed on its cloud computer — the Bot can then manage your Pinterest workflow on its own.

✓Type /add-plugin postiz in a Bot chat, or add it from the Plugins sidebar
✓Store your POSTIZ_API_KEY as a Bot secret when prompted
✓The Bot reads the bundled SKILL.md and learns every Postiz command
✓Works in every Bot on your shared workspace, on desktop and iPhone
✓Approvals keep a human in the loop before anything is published

Grok Bot

# 1. Add the plugin to your Bot
/add-plugin postiz

# 2. Store your Postiz API key
#    as a secret when prompted

# 3. Ask your Bot to verify
You: Find my Pinterest channel in Postiz

Bot: Running postiz integrations:list
  Found your Pinterest integration.
  All Postiz commands are ready.

How Grok Bot runs Pinterest on a routine

Your Bot reads the Postiz skill, discovers your Pinterest integration, and handles the entire posting workflow — from content creation to scheduling — on its own cloud computer.

🧠

Message Your Bot

Desktop, iPhone, or a group chat

Send a message to your Bot from the desktop app or your iPhone. It runs on its own cloud computer, so it picks up your message, discovers your Pinterest account via Postiz, uploads your media, and schedules the post — then asks you to approve before it goes live.

Grok Bot

You: Post to Pinterest about our new
  feature launch, schedule for tomorrow
  at 9am

Bot: Got it! Here's the plan:
  1. Find your Pinterest integration
  2. Compose your post content
  3. Schedule for tomorrow 9:00 AM

  Done! Post scheduled successfully.
  Post ID: abc-123

🧠

Routines

Recurring work on a schedule

Save the task as a routine. Your Bot runs it on a schedule from the cloud, checks for new content, and posts it to Pinterest automatically — no manual trigger needed.

Grok Bot routine

Routine: daily-pinterest-posts
Schedule: Weekdays at 9:00 AM

Instructions:
  Check ~/content/posts on your cloud
  computer for new .txt files. For
  each one, read the content and
  schedule a post to Pinterest for
  today at noon via Postiz. Move
  posted files to ~/content/published
  and send me a summary.

Why Grok Bot + Postiz for Pinterest

Grok Bot makes Postiz a natural fit for your Pinterest workflow. The Bot reads the plugin's skill, chains the right commands together, and keeps running from the cloud.

✓Official plugin — one command install from the marketplace
✓Always on — posts to Pinterest from the cloud while you are away
✓Terminal access runs Postiz commands directly on the Bot's computer
✓Routines for hands-free daily posting
✓Cross-post to Pinterest + other platforms in a single conversation
✓Approvals keep a human in the loop before publishing

SKILL.md (bundled in the plugin)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Pinterest
metadata:
  grok-bot:
    plugin: postiz
    secrets:
      - 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. See the Claude Code guide for Pinterest, the guide for any AI agent, or connect over the Postiz MCP server.

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.

Cross-post Pinterest content to 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

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

Example prompts for Pinterest in Grok Bot

These are prompts you can paste into a Bot chat. Grok Bot maps each one to the matching Postiz commands and Pinterest settings, then asks for approval.

Blog post pin

Grok Bot chat

> Pin ~/pins/agents-guide.png to our
  "AI marketing" board, title "Let AI agents
  run your social media", link to
  postiz.com/agent, tomorrow 11am

Grok Bot: Board found via integrations:settings.
  title and link set. Scheduled tomorrow
  11:00 AM. Approve?

Branded pin

Grok Bot chat

> Pin the product shot with brand color
  #682EE1 to the Product board

Grok Bot: dominant_color: #682EE1. Uploading.

Daily routine

Grok Bot chat

> Every day at 8am, pin the next image in
  ~/pins/queue to the Tips board with its
  caption file as the title

Grok Bot: Routine saved: daily-pinterest.

Pinterest rules Grok Bot follows

Grok Bot reads the Pinterest rules from postiz integrations:settings before scheduling. These are the ones that most often change what gets published.

✓board is required. Grok Bot runs postiz integrations:settings to list your boards and needs the board ID, not just the name.
✓Pins need an image uploaded through postiz upload. Pinterest does not accept text-only pins.
✓Pin titles are limited to 100 characters. The link field sets where the pin sends people when clicked.
✓dominant_color takes a hex code such as #FF6B35 and is used for the placeholder color while the image loads.

Grok Bot and Pinterest: frequently asked questions

How do I pin to Pinterest from Grok Bot?

Add the Postiz plugin with /add-plugin postiz and store your POSTIZ_API_KEY as a Bot secret. Give the Bot an image and a board name. It uploads the image through Postiz, resolves the board ID, sets the title and destination link, and schedules the pin. You approve before it publishes.

Can Grok Bot choose the right Pinterest board?

Yes. Before pinning, the Bot runs postiz integrations:settings for your Pinterest channel, which returns your boards with their IDs. Name the board in plain language and the Bot maps it to the ID. If the name is ambiguous, it asks which board you mean.

Can Grok Bot add a destination link to a pin?

Yes. Give it a URL and the Bot sets the link field so the pin sends people to your page when clicked. Combined with a title of up to 100 characters and a strong image, this is the standard setup for blog post and product pins.

Does Grok Bot support Pinterest brand colors?

Yes. Say "use our brand color #682EE1" and the Bot sets dominant_color. Pinterest shows this color as the placeholder while the image loads, which keeps your board looking consistent. It is optional and does not change the image itself.

Can Grok Bot pin on a daily routine?

Yes. Save a routine that pins the next image from a folder on the Bot's cloud computer to a chosen board each morning. The Bot uploads through Postiz, schedules the pin, and reports back. Approvals keep a human in the loop before anything is published.

Related Grok Bot guides

Start at the Grok Bot social media plugin overview for setup, routines, and the full platform list, or read what Postiz supports on the Pinterest channel page.

Grok Bot for Instagram→Grok Bot for Dribbble→Grok Bot for Facebook→Grok Bot for X (Twitter)→Grok Bot for WordPress→

Not using Grok Bot? Postiz works with any AI agent, including over the Postiz MCP server. See pricing for the free trial and plan limits.

Start pinning to Pinterest

Install Postiz Agent and automate your Pinterest content strategy with AI-powered scheduling and publishing.

Get Started