> ## Documentation Index
> Fetch the complete documentation index at: https://squad.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Reddit
> What agents can do in Reddit at each access level, and how to connect, limit, and disconnect Reddit.
Connect Reddit so your agents can work in your Reddit account. You choose an access level for each account, and Squad refuses any agent action outside that level.
## Access levels
Each Reddit account has an access level: **Read-only**, **Read + submit**, and **Full access**. Squad refuses any agent action outside that level. You can also narrow or block single agents under **Per-agent access**.
| Level | The connect window describes this level as | Actions agents can use |
| ------------------------------- | ------------------------------------------------------- | ---------------------- |
| **Read-only** | "See your username and read posts/comments/subreddits." | 17 of 23 |
| **Read + submit** (recommended) | "Also post, comment, vote, and save." | 21 of 23 |
| **Full access** | "Also edit posts, manage subscriptions, send DMs." | 23 of 23 |
**Read + submit** is the recommended level. The connect window selects it for you, and you can choose another level.
The Reddit sign-in page asks you to approve full access to your account. This is expected. Squad does not narrow the sign-in. It checks every agent action against the level you chose, and it refuses actions outside that level.
## What agents can do at each level
Each level opens with a short summary in plain tasks, then lists every action it adds, grouped by what the action works on. You do not need to name actions. Ask in plain words, and the agent searches for the matching action.
**Find an action.** Open a level and use your browser's find (Ctrl+F, or Cmd+F on a Mac) with a word from the task or part of a slug. Or ask your agent in plain words, for example "What can you do in my Reddit account?" The agent can search the Reddit actions for you.
Each action shows its name, a one-line description where the Reddit action catalog has one, and its slug. The slug is the ID that agents use when they call the action.
Agents can use 17 of the 23 Reddit actions at this level:
* View comments
* View posts
* View rules
* View settings
* View users
All 17 actions at this level:
| Works on | Action | What it does | Slug |
| ----------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| **Comments** | Retrieve post comments | Retrieves all comments for a Reddit post given its base-36 article ID. | `REDDIT_RETRIEVE_POST_COMMENTS` |
| | Retrieve specific comment | Retrieves detailed information for a single Reddit comment or post using its fullname. | `REDDIT_RETRIEVE_SPECIFIC_COMMENT` |
| **Posts** | Get controversial posts | Retrieve controversial posts from all subreddits with time filters. | `REDDIT_GET_CONTROVERSIAL_POSTS` |
| | List subreddit post flairs | List available link/post flairs for a subreddit (including flair\_template\_id) so posts can satisfy flair-required validation. | `REDDIT_LIST_SUBREDDIT_POST_FLAIRS` |
| | Retrieve Reddit post | Retrieves posts from a specified, publicly accessible subreddit. | `REDDIT_RETRIEVE_REDDIT_POST` |
| **Rules** | Get subreddit rules | Fetch the explicit posting rules for a subreddit to ensure compliance before posting or commenting. | `REDDIT_GET_SUBREDDIT_RULES` |
| **Settings** | Get me prefs | Retrieve preference settings of the logged in user. | `REDDIT_GET_ME_PREFS` |
| **Subreddits** | Get subreddits search | Search subreddits by title and description. | `REDDIT_GET_SUBREDDITS_SEARCH` |
| | Search across subreddits | Searches Reddit for posts/comments using a query. | `REDDIT_SEARCH_ACROSS_SUBREDDITS` |
| **Users** | Get Reddit user about | Retrieves information about a specified Reddit user account, including karma scores and gold status. | `REDDIT_GET_REDDIT_USER_ABOUT` |
| | Get user flair | Fetches the list of user flair assignments for a given subreddit. | `REDDIT_GET_USER_FLAIR` |
| | Get username available | Check whether a username is available for registration on Reddit. | `REDDIT_GET_USERNAME_AVAILABLE` |
| **Other actions** | Get | Retrieve a listing of Reddit posts sorted by the specified criteria (hot, new, top, etc.). | `REDDIT_GET` |
| | Get new | DEPRECATED: Use RetrieveRedditPost instead. | `REDDIT_GET_NEW` |
| | Get r top | Retrieve top-rated posts from a subreddit with time filters. | `REDDIT_GET_R_TOP` |
| | Get random | Retrieve a random public Reddit post from any subreddit. | `REDDIT_GET_RANDOM` |
| | Get scopes | Retrieve all available OAuth scopes supported by the Reddit API. | `REDDIT_GET_SCOPES` |
Agents can use 21 of the 23 Reddit actions at this level: everything in **Read-only**, plus:
* Create and update comments
* Create posts
* Update replies
The 4 actions that this level adds to **Read-only**:
| Works on | Action | What it does | Slug |
| ------------ | --------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------ |
| **Comments** | Edit Reddit comment or post | Edits the body text of the authenticated user's own existing comment or self-post on Reddit. | `REDDIT_EDIT_REDDIT_COMMENT_OR_POST` |
| | Post Reddit comment | Posts a comment on Reddit, replying to an existing submission (post) or another comment. | `REDDIT_POST_REDDIT_COMMENT` |
| **Posts** | Create Reddit post | Creates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair. | `REDDIT_CREATE_REDDIT_POST` |
| **Replies** | Toggle inbox replies | Enable or disable inbox replies for a submission or comment. | `REDDIT_TOGGLE_INBOX_REPLIES` |
Agents can use 23 of the 23 Reddit actions at this level: everything in **Read + submit**, plus:
* Delete comments
* Delete posts
The 2 actions that this level adds to **Read + submit**:
| Works on | Action | What it does | Slug |
| ------------ | --------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------ |
| **Comments** | Delete Reddit comment | Deletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user. | `REDDIT_DELETE_REDDIT_COMMENT` |
| **Posts** | Delete Reddit post | Permanently and irreversibly deletes a Reddit post by its ID. | `REDDIT_DELETE_REDDIT_POST` |
## Connect Reddit
Before you start:
* You need a Reddit account that you can sign in to.
* Your Squad subscription must be active. Squad does not connect apps while the subscription is not active.
Open **Settings** > **Integrations**.
On the **Connected apps** tab, click **+ Add integration**.
Find **Reddit** in the catalog and click it. You can type the name in **Search the catalog…**.
Under **Default scope**, choose an access level. This level applies to every agent.
Click **Connect Reddit**. The Reddit sign-in page opens in a new tab.
Sign in to Reddit and approve the request.
Check that it works: Reddit shows under **YOUR CONNECTIONS**, with a row for the account and its access level.
## Change the access level
1. Under **YOUR CONNECTIONS**, find the Reddit account.
2. Open the account menu (⋯) and click **Manage scope**.
3. Under **Default scope**, choose the new level.
4. Click **Save access**.
The change does not need a new sign-in. Agents get the new level from their next call.
## Set access for one agent
Every agent uses the account's level unless you set something else for it. You can narrow one agent to a lower level, or block it.
1. Under **YOUR CONNECTIONS**, open the account menu (⋯) on the Reddit account.
2. Click **Manage scope**.
3. Under **Per-agent access**, find the agent.
4. Choose the **Default** option to follow the account's level, choose a lower level, or choose **No access**.
5. Click **Save access**.
An agent never gets more than the account's level, even if you choose a higher level for it. Changes apply from the agent's next call. An agent with **No access** does not see the account.
## Use more than one Reddit account
Click **+ Account** on the Reddit card to connect another account. Agents use the primary account unless they are asked to use a specific one.
* After you click **+ Account**, follow the connect steps above.
* Each account has its own access level.
* The first account you connect becomes the primary account. It shows **★ PRIMARY**.
* To change the primary account, open the account menu (⋯) and click **Make primary**.
* To tell accounts apart, open the account menu (⋯) and click **Rename**.
## Reconnect or disconnect
Reconnect when the connection has expired, or when you need to change what the account can reach on the Reddit side:
1. Open the account menu (⋯) and click **Reconnect**.
2. Click **Reauthorize on Reddit**.
3. Sign in to Reddit and approve the request.
Reconnect signs in to the same account again. It does not add a second connection.
Open the account menu (⋯) on the Reddit account and click **Disconnect**. Agents lose access to that account at once.
**Disconnect** acts at once, with no confirmation step. If it was the primary account, another connected Reddit account becomes primary.
## Costs
Reddit actions do not use Squad credits. Connected apps never use credits. For what does use credits, see [What Squad costs](/docs/costs).
## Troubleshooting
An agent reports that an action is not allowed on this account.
* Cause: the action is outside the account's access level, or outside the level you set for that agent.
* Fix: choose a higher level in **Manage scope**, or change the agent's row under **Per-agent access**.
An agent says it has no access to Reddit, or it does not see the account.
* Cause: the agent is set to **No access** under **Per-agent access**, or the account is not connected.
* Fix: open **Manage scope** and change the agent's row. If the account is missing, connect it again.
Connecting or saving fails with "Your subscription isn't active."
* Cause: your Squad subscription is not active.
* Fix: resubscribe. See [Manage your subscription](/docs/billing).
An agent says the Reddit connection has expired.
* Cause: the sign-in for that account is no longer valid.
* Fix: use **Reconnect** on the account.
## Common questions
Each Reddit account has an access level: **Read-only**, **Read + submit**, and **Full access**. Squad refuses any agent action outside that level. You can also narrow or block single agents under **Per-agent access**.
Click **+ Account** on the Reddit card to connect another account. Agents use the primary account unless they are asked to use a specific one.
Open the account menu (⋯) on the Reddit account and click **Disconnect**. Agents lose access to that account at once.
## Related pages
Use this when an action you need is not in this app.