Skip to main content
The Reddit lane publishes posts to a subreddit. It publishes only once a Reddit credential is present in your .env; until then the lane is live-but-unauthenticated and waits for you to connect it (set PENDPOST_MODE=mock to exercise it through the mock driver).
Beta lane. Reddit is built but not yet live-verified end to end, so treat it as a preview and do not rely on it for guaranteed delivery. The lane loses this badge once it is live-verified.
You own your Reddit account and are responsible for Reddit’s terms of service. pendpost drafts and schedules, but a human approves before anything goes live.
The free API tier is non-commercial. Reddit’s free Data API is rate limited and licensed for non-commercial use only. High-volume or commercial posting needs an approved Reddit API plan.

​
Setup ceremony

A script app authenticates as the Reddit account that owns it, using a password grant for the submit and identity scopes.
  1. Create a script app. Sign in to Reddit, open the apps page, and click “create another app”. Choose the “script” type, give it a name, and set the redirect uri to http://localhost:8088 (a script app does not use it, but the field is required). The id shown under the app name is your client id; the “secret” field is your client secret.
  2. Record the client secret. Copy the secret shown next to the app and store it. Treat it like a password.
  3. Set the posting account credentials. Set the username and password of the account that owns the app. Use a dedicated posting account, not a shared admin login. The password grant does not support accounts with two-factor login enabled.
  4. Pick the target subreddit. Set the subreddit you publish to, without the r/ prefix. The account must have permission to post there, and the subreddit rules must allow the kind of content you send.
Then confirm the connection. It mints a short-lived token with the password grant and reads your identity back:

​
Environment variables

A lane publishes only once its credential is present. If the Reddit variables are blank, the Reddit lane is live-but-unauthenticated and waits for you to connect it. Set PENDPOST_MODE=mock to exercise it through the mock driver.

​
Validate the lane

A present credential is not the same as a working one. After setup, validate the Reddit lane in the Setup tab, or run a live probe with the health_recheck tool, to confirm the credential is live and not just configured. The lane is ready when it reports live.
Over MCP. Setup and rotation are an interactive human ceremony; secrets are never written through MCP. An agent can still check status (account_status), run a live liveness probe (health_recheck), and read non-secret config (config_get) over MCP without touching credentials.

​
Common failures