Automate Reddit with Grok Bot

Post to multiple subreddits, target specific communities with flairs, choose post types, and cross-post content — all from the command line or through your AI agent.

Setup Guide Marketplace

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

Post to Reddit in Seconds

Grok Bot

# In any Bot chat, add the Postiz plugin
/add-plugin postiz

# Store POSTIZ_API_KEY as a Bot secret when prompted.
# Your Bot can now run Postiz on its cloud computer:

# Find your Reddit integration
postiz integrations:list

# Discover available flairs for a subreddit
postiz integrations:trigger <id> getFlairs -d '{"subreddit":"programming"}'

# Create a Reddit post
postiz posts:create \
  -c "Check this out! A great new tool for developers." \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"subreddit":[{"value":{"subreddit":"programming","title":"Cool tool for automating social media","type":"self","is_flair_required":false}}]}' \
  -i "your-reddit-integration-id"

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 command. 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 It Works

Find Your Reddit Integration

List your connected accounts and grab your Reddit integration ID. You can also discover available flairs for any subreddit before posting.

Discovery

# List all integrations
postiz integrations:list

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

# Get Reddit settings schema
postiz integrations:settings <reddit-id>

# Discover flairs for a subreddit
postiz integrations:trigger <reddit-id> \
  getFlairs -d '{"subreddit":"programming"}'

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.

Post Types

# Self post (text only)
"type": "self"

# Link post (shares a URL)
"type": "link"
"url": "https://example.com/article"

# Image post
"type": "image"
# Use -m flag with image URL

# Video post
"type": "video"
# Use -m flag with video URL

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.

Post Creation

postiz posts:create \
  -c "Check this out" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "subreddit": [
      {
        "value": {
          "subreddit": "programming",
          "title": "Cool tool for developers",
          "type": "self",
          "is_flair_required": false
        }
      }
    ]
  }' \
  -i "reddit-id"

Reddit Settings Reference

Every Reddit post accepts these platform-specific settings via the --settings flag.

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

Copy-paste these settings for common Reddit posting scenarios.

Simple Self Post

settings.json

{
  "subreddit": [
    {
      "value": {
        "subreddit": "programming",
        "title": "Check out this new open-source tool",
        "type": "self",
        "is_flair_required": false
      }
    }
  ]
}

Link Post with Flair

settings.json

{
  "subreddit": [
    {
      "value": {
        "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

settings.json

{
  "subreddit": [
    {
      "value": {
        "subreddit": "programming",
        "title": "New open-source social media tool",
        "type": "self",
        "is_flair_required": false
      }
    },
    {
      "value": {
        "subreddit": "opensource",
        "title": "We just open-sourced our social media scheduler",
        "type": "link",
        "url": "https://github.com/example/project",
        "is_flair_required": false
      }
    }
  ]
}

Image Post

settings.json

{
  "subreddit": [
    {
      "value": {
        "subreddit": "dataisbeautiful",
        "title": "Social media engagement trends 2025",
        "type": "image",
        "is_flair_required": true,
        "flair": {
          "id": "def456",
          "name": "OC"
        }
      }
    }
  ]
}

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 Reddit presence with Postiz.

💻

Own Cloud Computer

Every Bot gets a persistent cloud machine with a terminal. Postiz runs there, so your Reddit 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 Reddit content without being asked twice.

🛡️

Approvals Built In

Bots ask before changing external systems. Review the Reddit 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 Reddit 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 Reddit channel in Postiz

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

Reddit Posting with Grok Bot

Your Bot reads the Postiz skill, discovers your Reddit 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 Reddit account via Postiz, uploads your media, and schedules the post — then asks you to approve before it goes live.

Grok Bot

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

Bot: Got it! Here's the plan:
  1. Find your Reddit 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 Reddit automatically — no manual trigger needed.

Grok Bot routine

Routine: daily-reddit-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 Reddit for
  today at noon via Postiz. Move
  posted files to ~/content/published
  and send me a summary.

Why Grok Bot + Postiz for Reddit

Grok Bot makes Postiz a natural fit for your Reddit 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 Reddit 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 Reddit + 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 Reddit
metadata:
  grok-bot:
    plugin: postiz
    secrets:
      - 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 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 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 will automatically run:
  postiz integrations:list
  postiz integrations:trigger <id> \
    getFlairs -d '{"subreddit":"programming"}'
  postiz posts:create \
    -c "Details about the feature..." \
    -s "2025-03-02T09:00:00Z" \
    --settings '{"subreddit":[
      {"value":{"subreddit":"programming",
        "title":"New feature release",
        "type":"self",
        "is_flair_required":false}},
      {"value":{"subreddit":"webdev",
        "title":"New feature release",
        "type":"self",
        "is_flair_required":false}}
    ]}' \
    -i "reddit-id"

Reddit + Other Platforms

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

Terminal

# Post to Reddit and Twitter simultaneously
postiz posts:create \
  -c "We just launched something awesome! Check it out." \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "subreddit": [
      {
        "value": {
          "subreddit": "programming",
          "title": "We just launched our new tool",
          "type": "link",
          "url": "https://example.com",
          "is_flair_required": false
        }
      }
    ]
  }' \
  -i "reddit-id,twitter-id"

# Batch schedule a week of Reddit content
for day in 1 2 3 4 5; do
  postiz posts:create \
    -c "Day $day insights from our dev team" \
    -s "2025-03-0${day}T10:00:00Z" \
    --settings '{"subreddit":[{"value":{"subreddit":"programming","title":"Dev insight day '$day'","type":"self","is_flair_required":false}}]}' \
    -i "reddit-id"
done

Start posting to Reddit

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

Get Started

Ready to get started?

Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.

Start for $0

Open-source social media scheduling tool

Proudly open-source ❤️