Automate Reddit with Codex

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 GitHub

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

Post to Reddit in Seconds

Terminal

# Install the skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# 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 Codex?

Codex is OpenAI's autonomous coding agent that handles software engineering tasks — writing features, fixing bugs, and answering questions about your codebase. It works via CLI and IDE integrations, and can execute shell commands like Postiz.

💻

CLI & IDE Native

Codex runs from your terminal or IDE. It executes shell commands directly, making Postiz integration seamless — no extra configuration needed.

🔧

Autonomous Execution

Codex works in sandboxed cloud environments, autonomously running commands, reading output, and chaining multi-step workflows like social media posting.

⚡

Parallel Tasks

Run multiple Codex tasks simultaneously. Schedule posts to different platforms in parallel while Codex handles other coding work.

How Postiz Works with Codex

Codex discovers Postiz when you install it globally. It reads the SKILL.md to understand available commands and can autonomously chain them for social media workflows.

✓Install Postiz Agent globally with npx skills add
✓Codex reads the SKILL.md and learns all Postiz commands
✓POSTIZ_API_KEY must be set in environment
✓Codex executes commands in sandboxed environments
✓Works alongside your coding tasks in parallel

Install Postiz

# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Codex discovers Postiz commands
# from the SKILL.md automatically
codex "list my social media integrations"

Reddit Posting with Codex

Tell Codex what to post from your terminal or IDE — it discovers your integrations via Postiz and handles the entire publishing workflow.

💻

CLI Workflow

Terminal and IDE integration

Tell Codex what to post from your terminal or IDE — it discovers your integrations via Postiz and handles the entire publishing workflow.

Codex CLI

$ codex "Post to Reddit about our
  new feature launch, schedule for
  tomorrow at 9am"

Codex: I'll handle that.
  Running: postiz integrations:list
  Found your Reddit integration.
  Running: postiz posts:create ...

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

💻

Parallel Tasks

Multiple tasks at once

Codex can handle multiple tasks in parallel. Schedule posts to different platforms while it works on other coding tasks simultaneously.

Codex Parallel Tasks

# Run multiple posting tasks in parallel
$ codex "Schedule a post about our
  launch to X for tomorrow 9am" &

$ codex "Write a LinkedIn article
  about our new feature and schedule
  for tomorrow noon" &

$ codex "Fix the bug in auth.ts"

# All three tasks run simultaneously

Why Codex + Postiz for Reddit

Codex's autonomous execution makes Postiz a natural fit. The agent reads the SKILL.md to understand every available command, then autonomously chains them together for Reddit workflows.

✓CLI-native — runs from your terminal or IDE
✓Autonomous execution in sandboxed environments
✓Parallel task support — post while coding
✓Reads SKILL.md for automatic command discovery
✓Cross-post to Reddit + other platforms in a single session
✓Powered by OpenAI's most capable models

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Reddit
metadata:
  codex:
    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 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 ❤️