Skip to main content

​
Overview

Postiz enables posting to multiple Reddit subreddits simultaneously with support for text, links, images, videos, and subreddit-specific flairs.

​
Authentication

Reddit uses OAuth 2.0 with permanent refresh tokens.
1

Connect Reddit

Click “Connect Reddit” in Integrations
2

Authorize

Grant permissions for posting and flair management
3

Permanent Access

Tokens don’t expire (permanent duration)

​
Required Permissions

  • read - Read Reddit content
  • identity - Access user identity
  • submit - Submit posts and comments
  • flair - Select and manage flairs

​
Supported Features

​
Post Types

  • Maximum: 10,000 characters
  • Markdown formatting supported
  • Self posts to subreddit

​
Multi-Subreddit Posting

Post to multiple subreddits in one operation: 
{
  subreddit: [
    {
      value: {
        subreddit: "/r/programming",
        title: "My awesome project",
        type: "text",
        flair: { id: "abc123", name: "Project" }
      }
    },
    {
      value: {
        subreddit: "/r/coding",
        title: "Check out my project",
        type: "link",
        url: "https://github.com/user/project"
      }
    }
  ]
}
When posting to multiple subreddits, Postiz waits 5 seconds between submissions to respect rate limits.

​
Subreddit Tools

​
Search Subreddits

Find subreddits to post to: 
GET /subreddits?word=programming

Returns:
[
  {
    title: "r/programming",
    name: "/r/programming",
    id: "2qh1i"
  }
]
Filters:
  • Public subreddits only
  • Active communities
  • Allows your post type (text/link/media)

​
Get Subreddit Restrictions

Check posting requirements: 
GET /restrictions?subreddit=/r/programming

Returns:
{
  subreddit: "/r/programming",
  allow: ["self", "link", "media"],
  is_flair_required: true,
  flairs: [
    { id: "abc123", name: "Project" },
    { id: "def456", name: "Discussion" }
  ]
}
Always check restrictions before posting to ensure compliance with subreddit rules.

​
Flair Management

Many subreddits require post flairs:
1

Check Requirements

Use /restrictions endpoint to see if flair is required
2

Get Available Flairs

List shows all flairs available for selection
3

Select Flair

Choose appropriate flair for your post
4

Include in Post

Add flair ID when submitting

​
Media Upload

​
Image Upload Process

1

Request Upload URL

Get media upload credentials from Reddit
2

Upload to Reddit

Upload image to Reddit’s S3 bucket
3

Get Media URL

Extract media URL from response
4

Submit Post

Create post with media URL

​
Video Upload Process

Videos require both video and poster image:
1

Upload Video

Upload MP4 to Reddit servers
2

Upload Poster

Upload thumbnail/poster image
3

Create Post

Submit with both URLs

​
Post Tracking

Reddit uses WebSockets for real-time post status:
  1. Submit post returns WebSocket URL
  2. Connect to WebSocket for status updates
  3. Receive post ID and URL when published
  4. Fallback: If WebSocket fails, post still created
WebSocket timeout: 30 seconds. If no response, post may still be successful - check Reddit.

​
Comments

Add comments to Reddit posts:
  • Reply to posts with t3_{postId} format
  • Thread comments under posts
  • Same 10,000 character limit
  • Markdown supported

​
Rate Limits

Critical Reddit Rate Limit:
  • 1 request per second maximum
  • MaxConcurrentJob set to 1
  • 5-second delay between multi-subreddit posts
  • Aggressive rate limiting by Reddit API

​
Best Practices

Follow Subreddit Rules

Read and follow each subreddit’s specific posting rules

Use Appropriate Flairs

Select relevant flairs to improve post visibility

Respect Rate Limits

Space out posts to avoid shadowbans

Engage with Comments

Reply to comments to boost post visibility

​
Troubleshooting

If post doesn’t show up:
  • Check if subreddit requires approval
  • Verify account has enough karma
  • Ensure account age meets minimum
  • Check for shadowban
  • Review subreddit’s AutoModerator rules
If flair is required:
  • Use /restrictions to get flair list
  • Select appropriate flair for content
  • Include flair_id in post submission
  • Some subreddits don’t show flairs to new users
Media upload issues:
  • Check file format (JPG/PNG for images, MP4 for video)
  • Verify file size isn’t too large
  • Ensure URL is accessible
  • Video posts need both video and poster image
If you hit rate limits:
  • Reddit limits to 1 request per second
  • Wait 60 seconds before retrying
  • Reduce posting frequency
  • Spread posts across longer timeframes

Build docs developers (and LLMs) love

Get started for freeTalk to us