Marketing & Social
👽 Reddit integration
Access levels: Read-only · Read + submit · Full access · Verified
Marketing & Social
Access levels: Read-only · Read + submit · Full access · Verified
Connect Reddit once and every agent in your squad can work in it for you, with exactly as much access as you decide to give, and a receipt for every call it makes.
You can change an account's access level any time under Manage. It applies instantly, no re-authorization. If the connection ever expires, the card shows Reconnect; one click re-authorizes the same account with the same settings.
Multiple accounts: connect as many as you need (say, yours and a client's). One is primary. Agents use it unless a mission says otherwise.
The level you pick at connect time is enforced on our side for every agent call: an agent can never do more than the level allows, no matter what it's asked.
| Level | What it allows | |
|---|---|---|
| Read-only | See your username and read posts/comments/subreddits. | |
| Read + submit | Also post, comment, vote, and save. | Recommended |
| Full access | Also edit posts, manage subscriptions, send DMs. |
On top of the connection's level, every agent can be individually allowed, scoped down, or denied for this app from the Integrations page. Deny an agent and it doesn't even see the connection.
The 23 tools agents use in Reddit through Mission Control, and the lowest access level that includes each. Agents discover these themselves. You never have to name a tool; asking in plain language is enough.
| Tool | What it does | Access level |
|---|---|---|
Create reddit postREDDIT_CREATE_REDDIT_POST | Creates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair. | Read + submit, Full access |
Delete reddit commentREDDIT_DELETE_REDDIT_COMMENT | Deletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user. | Full access |
Delete reddit postREDDIT_DELETE_REDDIT_POST | Permanently and irreversibly deletes a Reddit post by its ID. | Full access |
Edit reddit comment or postREDDIT_EDIT_REDDIT_COMMENT_OR_POST | Edits the body text of the authenticated user's own existing comment or self-post on Reddit; cannot edit link posts or titles. | Read + submit, Full access |
GetREDDIT_GET | Retrieve a listing of Reddit posts sorted by the specified criteria (hot, new, top, etc.). | All levels |
Get controversial postsREDDIT_GET_CONTROVERSIAL_POSTS | Retrieve controversial posts from all subreddits with time filters. | All levels |
Get me prefsREDDIT_GET_ME_PREFS | Retrieve preference settings of the logged in user. | All levels |
Get newREDDIT_GET_NEW | DEPRECATED: Use RetrieveRedditPost instead. | All levels |
Get randomREDDIT_GET_RANDOM | Retrieve a random public Reddit post from any subreddit. | All levels |
Get reddit user aboutREDDIT_GET_REDDIT_USER_ABOUT | Retrieves information about a specified Reddit user account, including karma scores and gold status. | All levels |
Get r topREDDIT_GET_R_TOP | Retrieve top-rated posts from a subreddit with time filters. | All levels |
Get scopesREDDIT_GET_SCOPES | Retrieve all available OAuth scopes supported by the Reddit API. | All levels |
Get subreddits searchREDDIT_GET_SUBREDDITS_SEARCH | Search subreddits by title and description. | All levels |
Get subreddit rulesREDDIT_GET_SUBREDDIT_RULES | Fetch the explicit posting rules for a subreddit to ensure compliance before posting or commenting. | All levels |
Get username availableREDDIT_GET_USERNAME_AVAILABLE | Check whether a username is available for registration on Reddit. | All levels |
Get user flairREDDIT_GET_USER_FLAIR | Fetches the list of user flair assignments for a given subreddit. | All levels |
List subreddit post flairsREDDIT_LIST_SUBREDDIT_POST_FLAIRS | List available link/post flairs for a subreddit (including flair_template_id) so posts can satisfy flair-required validation. | All levels |
Post reddit commentREDDIT_POST_REDDIT_COMMENT | Posts a comment on Reddit, replying to an existing submission (post) or another comment. | Read + submit, Full access |
Retrieve post commentsREDDIT_RETRIEVE_POST_COMMENTS | Retrieves all comments for a Reddit post given its base-36 article ID. | All levels |
Retrieve reddit postREDDIT_RETRIEVE_REDDIT_POST | Retrieves posts from a specified, publicly accessible subreddit. | All levels |
Retrieve specific commentREDDIT_RETRIEVE_SPECIFIC_COMMENT | Retrieves detailed information for a single Reddit comment or post using its fullname. | All levels |
Search across subredditsREDDIT_SEARCH_ACROSS_SUBREDDITS | Searches Reddit for posts/comments using a query. | All levels |
Toggle inbox repliesREDDIT_TOGGLE_INBOX_REPLIES | Enable or disable inbox replies for a submission or comment. | Read + submit, Full access |
Just ask in plain language: “check Reddit for …”, “create … in Reddit”, “every Monday, … ”, and the agent finds the right tool, runs it, and reports back with a receipt in your Runs ledger. Anything outward-facing (sending, posting, publishing) that a mission didn't clearly authorize comes back to you as a ticket first.
| Agent says | What's happening | Fix |
|---|---|---|
| "Reddit isn't connected" | No active connection (or this agent is denied) | Connect on the Integrations page; check the agent's per-app policy |
| "The connection has expired" | Reddit ended the authorization (they all do periodically) | Click Reconnect on the account, same settings, one click |
| "I'm not allowed to do that" | The action is above the account's access level, or the agent is scoped down | Raise the level under Manage, or adjust that agent's policy |
| It did something unexpected | The ask was ambiguous (e.g. matched an existing item) | Be explicit, "create a NEW …", and give agents a working folder where relevant |