Carapace
All Guides
Social

Reddit

Post, comment, and read subreddits

Reddit Setup Guide

Enables your agent to post, comment, read subreddits, read inbox, and send messages on Reddit.

Prerequisites

  • A Reddit account (the agent will act as this account)
  • The account must have enough karma to post in your target subreddits (varies by subreddit)

Step 1: Create a Reddit App

  1. Go to reddit.com/prefs/apps (must be logged in)
  2. Scroll to the bottom and click create another app...
  3. Fill in:
    • Name: anything descriptive (e.g., "Carapace Agent")
    • App type: select script (this is important — not "web app" or "installed app")
    • Description: optional
    • About URL: optional
    • Redirect URI: enter http://localhost (not used for script apps, but required by the form)
  4. Click create app
  5. Your app is now created. Find your credentials:
    • client_id: the short alphanumeric string shown directly under the app name (not the app name itself)
    • client_secret: labeled secret in the app details

Step 2: Connect in Carapace

  1. Go to Dashboard > Connections
  2. Find Reddit and click Connect
  3. Fill in:
    • Client ID — the short string under your app name
    • Client Secret — the secret from the app details
  4. Click Save Credentials

Credential Fields Reference

FieldRequiredFormatDescription
client_idYesShort alphanumericUnder the app name on reddit.com/prefs/apps
client_secretYesAlphanumericLabeled "secret" in the app details

Gotchas

Use "script" app type: The "script" type creates personal-use credentials that authenticate as your Reddit account. "Web app" and "installed app" types require a different OAuth flow that Carapace doesn't use for BYOK.

client_id location is non-obvious: After creating the app, the client_id is the string shown directly under the app name — it's easy to miss because it's not labeled.

Karma restrictions: Many subreddits require minimum karma to post. If the Reddit account is new or has low karma, the agent may be unable to post in certain communities. There's no workaround other than building karma on the account.

Rate limits: Reddit's API allows 60 requests per minute. The agent respects this, but heavy usage across multiple subreddits may hit the limit.

Troubleshooting

403 Forbidden when posting

The Reddit account doesn't have permission to post in that subreddit (karma too low, account too new, or banned from the sub).

401 Unauthorized

Client ID or secret is wrong. Double-check you copied the correct values from reddit.com/prefs/apps.

See Also