Post to Instagram from Paperclip

Paperclip agents can schedule and publish Instagram feed posts, stories, and reels through Postiz. Install the Postiz skill where the agent runs, connect an Instagram Business or Creator account in Postiz, and the agent can upload media, write captions, tag collaborators, and post trial reels on a schedule you define.

Setup Guide Paperclip

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

Last updated: September 2026

Post to Instagram 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:
> Post the product photo to Instagram
  with a caption, tomorrow at 6pm

Paperclip: Done! Your Instagram post is scheduled.

Instagram-Specific Features

📷

Feed Posts

Publish photo and video posts to your Instagram feed with captions, hashtags, and location tags. Schedule for optimal engagement times.

📱

Stories

Share ephemeral content with Instagram Stories. Upload images or videos that disappear after 24 hours.

🎬

Trial Reels

Test content with trial reels that have limited initial reach. Graduate to full distribution manually or automatically based on performance.

🤝

Collaborator Tags

Tag collaborators on your posts to co-author content. The post appears on both profiles, doubling your reach.

📊

Graduation Strategy

Control how trial reels graduate to full reach. Choose MANUAL for hands-on control or SS_PERFORMANCE for automatic promotion.

📅

Scheduled Posting

Schedule posts and stories with precise timestamps. Plan your Instagram content calendar and let Postiz handle the publishing.

How does Paperclip post to Instagram?

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 Instagram Integration

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

Example conversation

> Is my Instagram account connected to Postiz?

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

Upload Your Media

Upload your photo or video to get a public URL. Instagram requires media to be accessible via HTTPS. Supports JPG, PNG, MP4, and more.

Example conversation

> Draft a Instagram post about our new
  feature launch

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

Create Your Post

Schedule an Instagram post with your media, caption, hashtags, and platform-specific settings like post type, trial reels, and collaborators.

Example conversation

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

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

Instagram Settings Reference

Mention any of these in plain language and Paperclip sets them for you. These are the Instagram options it can apply to any post.

Field	Type	Required	Description
`__type`	string	Yes	Must be "instagram" or "instagram-standalone"
`post_type`	string	Yes	Content type: "post" (feed) or "story"
`is_trial_reel`	boolean	No	Post as a trial reel with limited initial reach
`graduation_strategy`	string	No	Trial reel graduation: "MANUAL" or "SS_PERFORMANCE" (auto based on performance)
`collaborators`	array	No	List of collaborator objects, e.g. [{"label":"username"}]

Common Configurations

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

Simple Feed Post

Just ask

> Post it with: Simple Feed Post

Paperclip: Got it. Applying:
  post_type: post

Story Post

Just ask

> Post it with: Story Post

Paperclip: Got it. Applying:
  post_type: story

Trial Reel with Auto Graduation

Just ask

> Post it with: Trial Reel with Auto Graduation

Paperclip: Got it. Applying:
  post_type: post
  is_trial_reel: yes
  graduation_strategy: SS_PERFORMANCE

Collaborator Post

Just ask

> Post it with: Collaborator Post

Paperclip: Got it. Applying:
  post_type: post
  collaborators: cofounder, designer_jane

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

Paperclip orchestrates complex multi-agent workflows. Chain content creation, review, approval, and publishing into automated pipelines.

How Postiz Works with Paperclip

Paperclip integrates Postiz as a tool in its agent orchestration framework. Agents in your Paperclip team can call Postiz commands to manage social media workflows end-to-end.

✓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

Instagram Posting with Paperclip

Paperclip assigns specialized agents to each step of your social media workflow — content creation, review, scheduling, and publishing — all orchestrated through Postiz.

📎

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 Instagram account via Postiz, uploads the photo, and schedules the post — all while you go about your day.

Paperclip

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

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

Scheduling Agent: Found Instagram
  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 photos and posts them to Instagram automatically — no manual trigger needed.

paperclip.yaml (pipeline)

pipelines:
  daily_social:
    schedule: "0 9 * * 1-5"
    agents:
      - role: content_creator
        task: "Draft a Instagram 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 Instagram

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

✓Multi-agent teams for quality Instagram 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 Instagram + 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 Instagram
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>

# Instagram Settings
post_type, is_trial_reel,
graduation_strategy,
collaborators

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 Instagram integration, uploads your photo, applies post type and collaborator settings, and schedules the post.

Claude Code

> Post my product photo to Instagram
  as a feed post with collaborator tags,
  schedule for tomorrow evening

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

Instagram + Other Platforms

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

Example

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

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

Post Types

Feed Post

post

Story

story

What can you ask Paperclip to do on Instagram?

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

Feed post with collaborator

Ask Paperclip

> Post product-shot.jpg to Instagram with a caption
  about the new colorway, tag @ourdesignstudio
  as collaborator, Friday 6pm

Paperclip: post_type: post, collaborators: ourdesignstudio.
  Scheduled on Instagram for Fri 6:00 PM.

Story

Ask Paperclip

> Share behind-the-scenes.mp4 as an Instagram
  story tomorrow morning

Paperclip: Uploaded the video, post_type: story.
  Scheduled for tomorrow 8:00 AM.

Trial reel

Ask Paperclip

> Publish teaser.mp4 as a trial reel and let it
  graduate automatically if it performs

Paperclip: is_trial_reel: true, graduation_strategy:
  SS_PERFORMANCE. Ready to schedule.

What Instagram rules should the agent follow?

Instagram 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.

✓Instagram requires media on every post. Text-only posts are rejected, so give the agent an image or video, or let it generate one first.
✓Captions are limited to 2,200 characters and 30 hashtags. Ask the agent to keep hashtags at the end or in the first comment.
✓post_type must be post (feed) or story. Stories disappear after 24 hours and do not accept captions the same way feed posts do.
✓Connect a Business or Creator account. __type instagram uses a linked Facebook Page; instagram-standalone connects directly.

Paperclip and Instagram: frequently asked questions

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

How do I post to Instagram from Paperclip?

Install the Postiz skill in the agent's environment with npx skills add gitroomhq/postiz-agent, set POSTIZ_API_KEY, and connect an Instagram Business or Creator account in Postiz. Then assign a task such as "post this photo to Instagram Friday at 6pm" and the agent uploads the media and schedules it.

Can a Paperclip agent post Instagram stories?

Yes. Ask for a story and the agent sets post_type to story, uploads the image or video through Postiz, and schedules it. Stories expire 24 hours after publishing, so for evergreen content ask for a feed post instead. You can request both in one task.

What are trial reels and can Paperclip use them?

Trial reels are Instagram reels shown first to non-followers so you can test content. Ask the agent to post as a trial reel and it sets is_trial_reel to true, with graduation_strategy MANUAL (you promote it) or SS_PERFORMANCE (Instagram promotes it automatically if it performs well).

Does Instagram need a Business account to post through Postiz?

Yes. Instagram's publishing API only works with Business or Creator accounts, so Postiz cannot post to a personal profile. Connect one in Postiz either through a linked Facebook Page (__type instagram) or with direct login (instagram-standalone). Personal accounts must be switched to Creator or Business first.

Can Paperclip generate the image and then post it to Instagram?

Yes, as a two-step workflow. A design or content agent in your Paperclip org produces the image, then the publishing agent uploads it with postiz upload and schedules the post. Because Instagram requires media, this pairing is the most common Paperclip and Postiz pipeline for the platform.