Read posts and comments, search subreddits, and (optionally) submit content and vote
The Reddit integration lets your agents browse subreddits, read posts and their comment trees, search across Reddit, look up users, and — when granted — submit posts, leave comments, and vote.
Prerequisites
- A Reddit account. The OAuth flow signs you in at setup; you don't need an app secret.
Setup
-
Open your agent in Agent Studio.
-
In the Integrations panel, click Add Integration Config.
-
Select Reddit from the integration list.
-
Give the config a display name (e.g., "Reddit — Community research").
-
Click Connect and complete the Reddit OAuth sign-in.
-
In the OAuth scope picker, choose which scopes to grant:
Scope What it allows Recommended identityRead user identity Yes readRead posts and comments Yes submitSubmit posts and comments If the agent posts voteVote on content If the agent votes historyRead voting and posting history Only when needed mysubredditsRead subscribed subreddits Only when needed -
Save the agent revision.
A tool will only execute if the OAuth scope it requires was granted. To enable write tools later, reauthorize and add submit / vote.
Using in Your Agent
- In an Agent Step, attach Reddit tools from the tools panel.
- Tools are referenced as
reddit.get_subreddit_posts,reddit.submit_comment, etc.
Available Tools
Read
| Tool | Description | Action Type |
|---|---|---|
get_subreddit_posts | Retrieve posts from a subreddit, sorted by hot, new, top, rising, or controversial | ReadOnly |
get_post_comments | Retrieve comments for a specific post | ReadOnly |
search | Search posts within a subreddit or across all of Reddit | ReadOnly |
get_user_info | Get public information about a Reddit user | ReadOnly |
Write
| Tool | Description | Action Type |
|---|---|---|
submit_post | Submit a new text or link post to a subreddit | Irreversible |
submit_comment | Comment on a post or reply to another comment | Irreversible |
vote | Upvote, downvote, or remove a vote from a post or comment | Reversible |