Post to Reddit from Paperclip

Paperclip agents can publish and schedule Reddit posts through Postiz. Install the Postiz skill where the agent runs, connect your Reddit account in Postiz, and the agent can target one or several subreddits, look up required flairs before posting, and choose text, link, image, or video post types.

Setup Guide Paperclip

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

Last updated: September 2026

Post to Reddit 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 our tutorial to r/programming
  with the "Tutorial" flair, tomorrow at 9am

Paperclip: Done! Your Reddit post is scheduled.

Reddit-Specific Features

🎯

Subreddit Targeting

Post to one or multiple subreddits simultaneously. Target the exact communities where your content belongs.

📝

Post Types

Create self posts, link posts, image posts, or video posts. Each type is optimized for Reddit's native rendering.

🏷

Flair Support

Automatically discover and apply required flairs for each subreddit. Never have a post rejected for missing flair again.

🔄

Cross-Posting

Share content across multiple subreddits in a single request. Each subreddit gets its own title and flair configuration.

🔗

Link & Media Posts

Share URLs, images, or videos directly. Link posts drive traffic while media posts maximize engagement within Reddit.

📅

Scheduled Posting

Schedule Reddit posts for peak activity times. Hit the front page by posting when your target subreddits are most active.

How does Paperclip post to Reddit?

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

Ask Paperclip whether your Reddit account is connected. It can also look up available flairs for any subreddit before posting.

Example conversation

> Is my Reddit account connected to Postiz?

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

Choose Your Post Type

Reddit supports multiple post types. Self posts contain text, link posts share URLs, and image/video posts upload media directly. Pick the right type for your content.

Example conversation

> Draft a Reddit post about our new
  feature launch

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

Create Your Post

Schedule a Reddit post with your content, target subreddit, post type, and flair. You can post to multiple subreddits at once by adding more items to the subreddit array.

Example conversation

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

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

Reddit Settings Reference

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

Field	Type	Required	Description
`__type`	string	Yes	Must be "reddit"
`subreddit`	array	Yes	Array of subreddit targets: [{value: {subreddit, title, type, url?, is_flair_required, flair?}}]
`subreddit[].value.subreddit`	string	Yes	Name of the subreddit to post to (without r/ prefix)
`subreddit[].value.title`	string	Yes	Title of the Reddit post
`subreddit[].value.type`	string	Yes	Post type: "self", "link", "image", or "video"
`subreddit[].value.url`	string	No	URL for link-type posts
`subreddit[].value.is_flair_required`	boolean	Yes	Whether the subreddit requires a flair
`subreddit[].value.flair`	object	No	Flair object with id and name (required if is_flair_required is true)
`subreddit[].value.flair.id`	string	No	Flair template ID from the subreddit
`subreddit[].value.flair.name`	string	No	Display name of the flair

Common Configurations

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

Simple Self Post

Just ask

> Post it with: Simple Self Post

Paperclip: Got it. Applying:
  subreddit: {'subreddit': 'programming', 'title': 'Check out this new AI scheduling tool', 'type': 'self', 'is_flair_required': False}

Link Post with Flair

Just ask

> Post it with: Link Post with Flair

Paperclip: Got it. Applying:
  subreddit: {'subreddit': 'webdev', 'title': 'How we built our scheduling engine', 'type': 'link', 'url': 'https://example.com/blog/scheduling-engine', 'is_flair_required': True, 'flair': {'id': 'abc123', 'name': 'Article'}}

Cross-Post to Multiple Subreddits

Just ask

> Post it with: Cross-Post to Multiple Subreddits

Paperclip: Got it. Applying:
  subreddit: {'subreddit': 'programming', 'title': 'New AI social media scheduler', 'type': 'self', 'is_flair_required': False}, {'subreddit': 'artificial', 'title': 'We just launched our AI social media scheduler', 'type': 'link', 'url': 'https://example.com/launch', 'is_flair_required': False}

Image Post

Just ask

> Post it with: Image Post

Paperclip: Got it. Applying:
  subreddit: {'subreddit': 'dataisbeautiful', 'title': 'Social media engagement trends 2025', 'type': 'image', 'is_flair_required': True, 'flair': {'id': 'def456', 'name': 'OC'}}

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

Reddit 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 Reddit account via Postiz, finds the right flairs, and schedules the post — all while you go about your day.

Paperclip

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

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

Scheduling Agent: Found Reddit
  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 monitors for new content and posts it to the right subreddits automatically — no manual trigger needed.

paperclip.yaml (pipeline)

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

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

✓Multi-agent teams for quality Reddit 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 Reddit + 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 Reddit
metadata:
  paperclip:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz integrations:trigger <id>
    getFlairs -d '{"subreddit":"..."}'
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Reddit Settings
subreddit (array of targets),
type (self/link/image/video),
title, url, flair, is_flair_required

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 Reddit integration, checks flair requirements, and schedules posts to the right subreddits.

Claude Code

> Post to r/programming and r/webdev
  about our new feature, schedule for
  tomorrow morning

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

Reddit + Other Platforms

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

Example

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

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

What can you ask Paperclip to do on Reddit?

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

Text post with flair lookup

Ask Paperclip

> Post our tutorial to r/SaaS as a text post
  titled "Running Postiz with an AI agent", pick
  the right flair, schedule for 8am tomorrow

Paperclip: Fetched flairs, applied "Guide". Scheduled
  on Reddit for tomorrow 8:00 AM.

Link post to two subreddits

Ask Paperclip

> Share blog.example.com/launch as a link post to
  r/SaaS and r/startups with different titles

Paperclip: Two subreddit targets, type: link.
  Both queued for 9:00 AM.

Image post

Ask Paperclip

> Post dashboard.png to r/dataisbeautiful as an
  image post with a descriptive title

Paperclip: type: image, title set. Ready to schedule.
  Note: this subreddit requires a flair.

What Reddit rules should the agent follow?

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

✓Every subreddit target needs a title (max 300 characters) and a type: self, link, image, or video.
✓Some subreddits require flair. Set is_flair_required and let the agent run the getFlairs trigger to fetch valid flair IDs before posting.
✓Link posts need a url. Image and video posts need media uploaded through Postiz first.
✓Respect each subreddit's self-promotion rules. A reviewer agent that checks the sidebar rules before publishing is a good Paperclip pattern.

Paperclip and Reddit: frequently asked questions

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

How do I post to Reddit 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 Reddit account in Postiz. Then assign a task like "post this guide to r/SaaS tomorrow at 8am" and the agent fills in the subreddit, title, type, and flair.

How does Paperclip handle subreddit flairs?

Before posting, the agent can call postiz integrations:trigger with getFlairs for the target subreddit and choose a matching flair ID. If the subreddit requires flair, it sets is_flair_required to true and attaches the flair object. Without a valid flair the post would be rejected.

Can a Paperclip agent post to multiple subreddits at once?

Yes. The subreddit setting is an array, so one Postiz post can target several subreddits, each with its own title, type, and flair. Ask the agent to adapt the title for each community, and consider staggering times so the posts do not look like a blast.

Which Reddit post types can Paperclip create through Postiz?

Four types: self (text), link (a URL), image, and video. The agent picks the type from your request: "share this link" becomes a link post, "post this screenshot" becomes an image post. Media is uploaded with postiz upload first and then attached to the target.

Can I let Paperclip post to Reddit automatically?

You can, but keep a review step. Reddit communities remove posts that read as automated promotion. A good Paperclip setup is a writer agent, a reviewer agent that checks subreddit rules, and a publisher that schedules through Postiz only after approval, with heartbeats driving the cadence.