> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Reddit

> Reddit is a social news platform with user-driven communities (subreddits), offering content sharing, discussions, and viral marketing opportunities for brands

![Reddit logo](https://mintcdn.com/composio-preview/YYC5iurbUCUzEs77/images/toolkits/reddit.svg?fit=max\&auto=format\&n=YYC5iurbUCUzEs77\&q=85\&s=c5786c0109394bbbcc2ae80c74edf6de)

* **Category:** social media accounts
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** Yes
* **Tools:** 36
* **Triggers:** 0
* **Slug:** `REDDIT`
* **Version:** 20261101\_00

## Tools

> [accordion] Create a Reddit post
>
> **Slug:** `REDDIT_CREATE_REDDIT_POST`
>
> Creates a text or link post in a specified subreddit, optionally applying flair. Some subreddit validation failures return `success: false` with details; successful submission does not guarantee the post remains publicly visible.
>
> #### Input Parameters
>
> **url** `string`
>
> The URL for a 'link' post. Required if `kind` is 'link'.
>
> **kind** `string ("link" | "self")`
>
> The type of the post. Use 'self' for a text-based post (when providing 'text') or 'link' for a post that links to an external URL (when providing 'url'). If omitted, it is automatically inferred: 'self' when 'text' is provided, 'link' when 'url' is provided.
>
> **text** `string`
>
> The markdown-formatted text content for a 'self' post. Required if `kind` is 'self'. Body must not exceed \~40,000 characters.
>
> **title** `string` *required*
>
> The title of the post. Must be 300 characters or less.
>
> **flair\_id** `string`
>
> ID of the post flair template (UUID format). Must be a valid flair template ID that exists for this specific subreddit. To get valid flair IDs, first use LIST\_SUBREDDIT\_POST\_FLAIRS action for the target subreddit. Do not pass generic strings like 'general' or 'news' - these are not universal flair IDs. Some subreddits enforce mandatory flair; omitting or providing an invalid ID returns SUBMIT\_VALIDATION\_FLAIR\_REQUIRED.
>
> **subreddit** `string` *required*
>
> The name of the subreddit (without the 'r/' prefix) where the post will be submitted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Reddit comment
>
> **Slug:** `REDDIT_DELETE_REDDIT_COMMENT`
>
> Deletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user. Deletion is permanent and irreversible.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The full 'thing ID' (fullname, e.g., 't1\_c0s4w1c') of the comment to delete; typically starts with 't1\_'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a Reddit post
>
> **Slug:** `REDDIT_DELETE_REDDIT_POST`
>
> Permanently and irreversibly deletes a Reddit post by its ID. Confirm with the user before calling. Only works on posts authored by the authenticated account; attempting to delete another user's post will fail.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The full name (fullname) of the Reddit post to be deleted. This ID must start with 't3\_' followed by the post's unique base36 identifier.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Edit comment or post
>
> **Slug:** `REDDIT_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.
>
> #### Input Parameters
>
> **text** `string` *required*
>
> The new raw markdown text for the body of the comment or self-post.
>
> **thing\_id** `string` *required*
>
> The full name (fullname) of the comment or self-post to edit. This is a combination of a prefix (e.g., 't1\_' for comment, 't3\_' for post) and the item's ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Expand More Comments
>
> **Slug:** `REDDIT_EXPAND_MORE_COMMENTS`
>
> Resolve up to 20 child IDs from a `more` placeholder returned by Retrieve Comments for a Post. Pass the placeholder's `children`, the post fullname in `link_id`, and optionally its bare `data.id` as `more_id`. Reddit permits only one concurrent request to this endpoint, so call expansions serially.
>
> #### Input Parameters
>
> **sort** `string ("confidence" | "top" | "new" | "controversial" | "old" | "random" | "qa" | "live")`
>
> Comment ordering to use while expanding the placeholder. Omit to use Reddit's default.
>
> **link\_id** `string` *required*
>
> Fullname of the post whose comment tree is being expanded, including the t3\_ prefix.
>
> **more\_id** `string`
>
> Bare ID from the source more-comments object's data.id field, sent to Reddit as id.
>
> **children** `array` *required*
>
> One to 20 bare comment IDs from a more-comments placeholder's children array. Do not include t1\_ prefixes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Reddit listing by sort
>
> **Slug:** `REDDIT_GET`
>
> Tool to retrieve a listing of Reddit posts sorted by the specified criteria (hot, new, top, rising, controversial, best). Use when you need to get posts from the Reddit front page or all of Reddit with a specific sort order. Supports pagination and time filtering for top and controversial sorts. For new controversial-post workflows, prefer GET\_CONTROVERSIAL; this action retains controversial support for backward compatibility. Use GET\_RANDOM for random posts.
>
> #### Input Parameters
>
> **show** `string`
>
> The string 'all' to show all posts including filtered ones.
>
> **sort** `string` *required*
>
> The sorting method for results. Valid values: hot, new, top, rising, controversial, best. For new controversial-post workflows, prefer the dedicated GET\_CONTROVERSIAL action; this action continues to support controversial for backward compatibility. Note: 'random' is NOT supported here - use the GET\_RANDOM action instead.
>
> **after** `string`
>
> Fullname of a thing for pagination (loads posts after this item).
>
> **count** `integer`
>
> A positive integer representing the number of items already seen (default: 0).
>
> **limit** `integer`
>
> The maximum number of items desired (default: 25, maximum: 100).
>
> **before** `string`
>
> Fullname of a thing for pagination (loads posts before this item).
>
> **time\_filter** `string`
>
> Time filter for the 'top' and 'controversial' sorts. Valid values: hour, day, week, month, year, all.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get controversial posts from all subreddits
>
> **Slug:** `REDDIT_GET_CONTROVERSIAL_POSTS`
>
> Tool to retrieve controversial posts from all subreddits with time filters. Use when you need to find the most controversial posts across Reddit from a specific time period (hour, day, week, month, year, or all-time). Returns a paginated listing of posts ranked by controversy within the specified time frame.
>
> #### Input Parameters
>
> **t** `string ("hour" | "day" | "week" | "month" | "year" | "all")`
>
> Time filter for ranking controversial posts. Accepts 't' or the compatibility alias 'time\_filter'. Valid values: 'hour', 'day', 'week', 'month', 'year', or 'all' (default).
>
> **show** `string`
>
> Display filtering option. Use 'all' to include items Reddit would normally omit, such as hidden posts.
>
> **after** `string`
>
> Fullname of a thing to use as anchor for pagination. Returns results that occur after this fullname in the listing.
>
> **count** `integer`
>
> Number of items already seen, used by Reddit to number paginated listings.
>
> **limit** `integer`
>
> Maximum number of controversial posts to return. Default is 25, maximum is 100.
>
> **before** `string`
>
> Fullname of a thing to use as anchor for pagination. Returns results that occur before this fullname in the listing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get inbox message
>
> **Slug:** `REDDIT_GET_INBOX_MESSAGE`
>
> Retrieve one private message from the connected account's Reddit inbox.
>
> #### Input Parameters
>
> **message\_id** `string` *required*
>
> Bare base36 ID of the inbox message, without the t4\_ prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get user preferences
>
> **Slug:** `REDDIT_GET_ME_PREFS`
>
> Tool to retrieve preference settings of the logged in user. Use when you need to check user preferences or settings.
>
> #### Input Parameters
>
> **fields** `string`
>
> A comma-separated list of preference fields to return. If not specified, all preference fields are returned. Supported fields include: threaded\_messages, hide\_downs, hide\_ups, activity\_relevant\_ads, nightmode, compress, beta, media, media\_preview, label\_nsfw, over\_18, search\_include\_over\_18, hide\_ads, email\_messages, email\_digests, monitor\_mentions, hide\_from\_robots, profile\_opt\_out, public\_votes, lang, theme\_selector, min\_comment\_score, min\_link\_score, accept\_pms, show\_link\_flair, show\_trending, private\_feeds, research, ignore\_suggested\_sort, domain\_details, legacy\_search, live\_orangereds, highlight\_controversial, no\_profanity, email\_unsubscribe\_all, in\_redesign\_beta, allow\_clicktracking, show\_twitter, store\_visits, threaded\_modmail, enable\_default\_themes, geopopular, show\_stylesheets, show\_promote, organic, collapse\_read\_messages, show\_flair, mark\_messages\_read, top\_karma\_subreddits, newwindow, video\_autoplay, credit\_autorenew, clickgadget, use\_global\_defaults, other\_theme, num\_comments, numsites, and g.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get modmail conversation
>
> **Slug:** `REDDIT_GET_MODMAIL_CONVERSATION`
>
> Retrieve one moderator mail conversation and its related objects.
>
> #### Input Parameters
>
> **conversation\_id** `string` *required*
>
> Base36 moderator mail conversation ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get new posts from subreddit (Deprecated)
>
> **Slug:** `REDDIT_GET_NEW`
>
> DEPRECATED: Use RetrieveRedditPost instead. Tool to retrieve newest posts from a subreddit sorted by creation time. Use when you need to find the most recently submitted posts to discover fresh content. Returns a paginated listing of posts ranked by newest first.
>
> #### Input Parameters
>
> **after** `string`
>
> Fullname of a thing to use as anchor for pagination. Returns results that occur after this fullname in the listing.
>
> **count** `integer`
>
> Used by Reddit to number listings after the first page for pagination. Represents the number of items already seen.
>
> **limit** `integer`
>
> Maximum number of new posts to return. Default is 25, maximum is 100.
>
> **before** `string`
>
> Fullname of a thing to use as anchor for pagination. Returns results that occur before this fullname in the listing.
>
> **subreddit** `string` *required*
>
> Subreddit name (without 'r/' prefix). Must contain only letters, numbers, and underscores. No spaces or special characters allowed. Case-insensitive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Reddit posts by fullname
>
> **Slug:** `REDDIT_GET_POSTS_BY_FULLNAME`
>
> Retrieve Reddit posts directly by their t3 fullnames.
>
> #### Input Parameters
>
> **fullnames** `array` *required*
>
> One to 100 Reddit post fullnames to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get random Reddit post
>
> **Slug:** `REDDIT_GET_RANDOM`
>
> Retrieve a randomly selected post from a batch of up to 100 hot posts in a specified subreddit, or from r/all if no subreddit is specified.
>
> #### Input Parameters
>
> **subreddit** `string`
>
> Name of the subreddit to get a random post from. If not specified, returns a random post from all of Reddit. Do not include 'r/' prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get user information
>
> **Slug:** `REDDIT_GET_REDDIT_USER_ABOUT`
>
> Retrieves information about a specified Reddit user account, including karma scores and gold status. Use when you need to get profile information for any public Reddit user.
>
> #### Input Parameters
>
> **username** `string` *required*
>
> The name of an existing Reddit user to retrieve information about. Do not include 'u/' prefix. Use 'me' to get information about the currently authenticated user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get top posts from subreddit (Deprecated)
>
> **Slug:** `REDDIT_GET_R_TOP`
>
> DEPRECATED: Use RetrieveRedditPost with sort='top' and time\_filter set instead - it now supports the same hour/day/week/month/year/all time filtering. Tool to retrieve top-rated posts from a subreddit with time filters. Use when you need to find the most popular posts from a specific time period (hour, day, week, month, year, or all-time). Returns a paginated listing of posts ranked by score within the specified time frame.
>
> #### Input Parameters
>
> **t** `string ("hour" | "day" | "week" | "month" | "year" | "all")`
>
> Time filter for ranking top posts. Specifies the time period for top posts: 'hour', 'day', 'week', 'month', 'year', or 'all' (default).
>
> **show** `string`
>
> Display filtering option. Use 'all' to return items that would normally be omitted (e.g., posts you have hidden).
>
> **after** `string`
>
> Fullname of a thing to use as anchor for pagination. Returns results that occur after this fullname in the listing.
>
> **count** `integer`
>
> Used by Reddit to number listings after the first page for pagination. Represents the number of items already seen.
>
> **limit** `integer`
>
> Maximum number of top posts to return. Default is 25, maximum is 100.
>
> **before** `string`
>
> Fullname of a thing to use as anchor for pagination. Returns results that occur before this fullname in the listing.
>
> **sr\_detail** `boolean`
>
> Expand subreddits detail in response. Set to true to get more detailed subreddit information.
>
> **subreddit** `string` *required*
>
> Subreddit name (without 'r/' prefix). Must contain only letters, numbers, and underscores. No spaces or special characters allowed. Case-insensitive.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get OAuth scopes
>
> **Slug:** `REDDIT_GET_SCOPES`
>
> Tool to retrieve all available OAuth scopes supported by the Reddit API. Use when you need to understand what permissions are available or check scope definitions.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get subreddit metadata
>
> **Slug:** `REDDIT_GET_SUBREDDIT_METADATA`
>
> Retrieve one exact subreddit's public profile metadata, including descriptions, subscriber count, settings, and connected-user relationship fields.
>
> #### Input Parameters
>
> **subreddit** `string` *required*
>
> Subreddit name without the r/ prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get subreddit rules
>
> **Slug:** `REDDIT_GET_SUBREDDIT_RULES`
>
> Fetch the explicit posting rules for a subreddit to ensure compliance before posting or commenting. Use when you need to verify content meets community guidelines or explain subreddit requirements to users.
>
> #### Input Parameters
>
> **raw\_json** `boolean`
>
> If True, prevents HTML encoding of special characters in rule descriptions. Recommended to set to True for cleaner text output.
>
> **subreddit** `string` *required*
>
> Name of the subreddit (without 'r/' prefix) for which to retrieve posting rules.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search subreddits
>
> **Slug:** `REDDIT_GET_SUBREDDITS_SEARCH`
>
> Tool to search subreddits by title and description. Use when you need to find subreddits matching a specific topic or keyword. Returns a paginated listing of subreddits with their details including subscribers, descriptions, and other metadata.
>
> #### Input Parameters
>
> **q** `string` *required*
>
> A search query term to search subreddit titles and descriptions. Use specific keywords to find relevant subreddits.
>
> **show** `string`
>
> The string 'all' to show all subreddits including those the user might have filtered.
>
> **sort** `string ("relevance" | "activity")`
>
> Sort order for the search results. 'relevance' sorts by relevance to the query (default). 'activity' sorts by subreddit activity.
>
> **after** `string`
>
> Fullname of a thing - pagination cursor for the next page. Use the 'after' value from the previous response to get the next set of results.
>
> **count** `integer`
>
> A positive integer (default: 0) representing the number of items already seen in previous pages. Used for pagination tracking.
>
> **limit** `integer`
>
> The maximum number of subreddits to return. Default is 25. Maximum allowed value is 100.
>
> **before** `string`
>
> Fullname of a thing - pagination cursor for the previous page. Use the 'before' value from the previous response to get the previous set of results.
>
> **sr\_detail** `boolean`
>
> Expand subreddits with additional details. Set to true to get more detailed information about each subreddit.
>
> **show\_users** `boolean`
>
> Boolean value to include user results in the search. Set to true to include users matching the search query.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Reddit user comments RSS
>
> **Slug:** `REDDIT_GET_USER_COMMENTS_RSS`
>
> Retrieve a named Reddit user's comments as a raw Atom feed string.
>
> #### Input Parameters
>
> **show** `string`
>
> Set to 'given' to preserve Reddit's given-context display mode.
>
> **sort** `string ("hot" | "new" | "top" | "controversial")`
>
> Order in which Reddit returns the user's comments.
>
> **after** `string`
>
> Fullname cursor used to fetch the next page of comments.
>
> **count** `integer`
>
> Number of comments already seen in the paginated feed.
>
> **limit** `integer`
>
> Maximum number of comments to include in the feed (1-100).
>
> **before** `string`
>
> Fullname cursor used to fetch the previous page of comments.
>
> **context** `integer`
>
> Number of parent comments to include for each comment (2-10).
>
> **username** `string` *required*
>
> Reddit username whose comments to retrieve, without the 'u/' prefix.
>
> **item\_type** `string ("links" | "comments")`
>
> Reddit Thing category filter; sent to Reddit as 'type'.
>
> **sr\_detail** `boolean`
>
> Whether to expand subreddit details in feed entries.
>
> **time\_filter** `string ("hour" | "day" | "week" | "month" | "year" | "all")`
>
> Time window used with applicable sort orders; sent to Reddit as 't'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get user flair
>
> **Slug:** `REDDIT_GET_USER_FLAIR`
>
> Fetches the list of user flair assignments for a given subreddit. Returns paginated results with user flair details. Returned flair\_id values are scoped to the specific subreddit and must not be reused across different subreddits.
>
> #### Input Parameters
>
> **after** `string`
>
> User ID to use as the anchor for fetching the next page of results. Use the 'next' value from a previous response.
>
> **limit** `integer`
>
> Maximum number of user flair entries to return per page. Reddit default is 25, maximum is 1000.
>
> **before** `string`
>
> User ID to use as the anchor for fetching the previous page of results. Use the 'prev' value from a previous response.
>
> **subreddit** `string` *required*
>
> Name of the subreddit (e.g., 'pics', 'gaming') for which to retrieve user flair assignments. Do not include 'r/' prefix or URL paths — bare name only.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check username availability
>
> **Slug:** `REDDIT_GET_USERNAME_AVAILABLE`
>
> Tool to check whether a username is available for registration on Reddit. Use when you need to verify if a username can be used to create a new account.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> The username to check for availability. Must be a valid, unused username string. Usernames are case-insensitive and must be between 3-20 characters.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get subreddit wiki page
>
> **Slug:** `REDDIT_GET_WIKI_PAGE`
>
> Retrieve a subreddit wiki page's rendered and Markdown content, optionally at a historical revision or as a comparison between two revisions.
>
> #### Input Parameters
>
> **page** `string` *required*
>
> Wiki page path, including nested paths such as config/sidebar. Spaces are normalized to underscores and names are case-insensitive.
>
> **raw\_json** `boolean`
>
> Whether Reddit should return raw characters instead of HTML-escaped JSON content.
>
> **revision** `string`
>
> Wiki revision ID to retrieve instead of the current page.
>
> **subreddit** `string` *required*
>
> Subreddit name without the r/ prefix.
>
> **comparison\_revision** `string`
>
> Second wiki revision ID to compare with revision. Provide revision as well to retrieve a diff.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List custom Reddit feed
>
> **Slug:** `REDDIT_LIST_CUSTOM_FEED`
>
> List posts from a public custom Reddit feed owned by a named user.
>
> #### Input Parameters
>
> **show** `string`
>
> Set to 'all' to include items that would otherwise be filtered.
>
> **sort** `string ("hot" | "new" | "rising" | "controversial" | "top")`
>
> Feed ordering: hot, new, rising, controversial, or top.
>
> **after** `string`
>
> Fullname cursor from data.after in the previous response.
>
> **count** `integer`
>
> Number of items already seen in the listing, starting at 0.
>
> **limit** `integer`
>
> Maximum number of posts to return, from 1 to 100.
>
> **before** `string`
>
> Fullname cursor from data.before in the previous response.
>
> **username** `string` *required*
>
> Username of the custom feed owner, without a 'u/' prefix.
>
> **sr\_detail** `boolean`
>
> Whether to include subreddit details with each post.
>
> **custom\_feed** `string` *required*
>
> Custom feed name, without '/user/.../m/' path prefixes.
>
> **time\_filter** `string ("hour" | "day" | "week" | "month" | "year" | "all")`
>
> Time window for top or controversial posts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List inbox messages
>
> **Slug:** `REDDIT_LIST_INBOX_MESSAGES`
>
> List one inbox view for the connected Reddit account. Use `data.after` as `after` on the next call to continue pagination.
>
> #### Input Parameters
>
> **mid** `string`
>
> Message identifier used by Reddit to anchor or select the listing.
>
> **show** `string`
>
> Set to 'all' to include entries Reddit would otherwise filter from the listing.
>
> **after** `string`
>
> Fullname cursor from data.after used to fetch the next page.
>
> **count** `integer`
>
> Number of entries already seen, used by Reddit to number paginated listings.
>
> **limit** `integer`
>
> Maximum number of inbox entries to return (1-100).
>
> **before** `string`
>
> Fullname cursor from data.before used to fetch the previous page.
>
> **sr\_detail** `boolean`
>
> Whether to expand subreddit details in each returned entry.
>
> **inbox\_view** `string ("inbox" | "unread" | "sent" | "messages" | "comments")` *required*
>
> Inbox view to list: all inbox entries, unread entries, sent messages, private messages, or comment notifications.
>
> **max\_replies** `integer`
>
> Maximum number of replies to expand for each returned message (0-300).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List inbox mentions
>
> **Slug:** `REDDIT_LIST_INBOX_NOTIFICATIONS`
>
> List username mentions from the connected account's inbox. Use `data.after` as `after` on the next call to continue pagination.
>
> #### Input Parameters
>
> **mid** `string`
>
> Fullname of the inbox item to target or expand, including its t1\_ or t4\_ prefix.
>
> **show** `string`
>
> Set to 'all' to include inbox items Reddit would otherwise filter.
>
> **after** `string`
>
> Fullname cursor from data.after used to fetch the next page.
>
> **count** `integer`
>
> Number of inbox items already seen, used by Reddit to number paginated listings.
>
> **limit** `integer`
>
> Maximum number of inbox items to return (1-100).
>
> **before** `string`
>
> Fullname cursor from data.before used to fetch the previous page.
>
> **sr\_detail** `boolean`
>
> Whether to expand subreddit details in returned inbox items.
>
> **max\_replies** `integer`
>
> Maximum number of threaded replies to include for each inbox item (0-300).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List moderation queue
>
> **Slug:** `REDDIT_LIST_MODERATION_QUEUE`
>
> List one moderator review queue for a subreddit. Use `data.after` as `after` on the next call to continue pagination. The connected account must have the `posts` moderator permission for the requested subreddit.
>
> #### Input Parameters
>
> **show** `string`
>
> Set to 'all' to include content Reddit would otherwise filter from the listing.
>
> **after** `string`
>
> Fullname cursor from data.after used to fetch the next page.
>
> **count** `integer`
>
> Number of items already seen, used by Reddit to number paginated listings.
>
> **limit** `integer`
>
> Maximum number of moderation items to return (1-100).
>
> **queue** `string ("modqueue" | "unmoderated" | "reports" | "spam" | "edited")` *required*
>
> Moderation view to inspect: items needing review, unmoderated items, reports, removed or spammed items, or recently edited items.
>
> **before** `string`
>
> Fullname cursor from data.before used to fetch the previous page.
>
> **sr\_detail** `boolean`
>
> Whether to expand subreddit details in each returned item.
>
> **subreddit** `string` *required*
>
> Subreddit moderated by the connected account, without the 'r/' prefix.
>
> **content\_type** `string ("links" | "comments" | "chat_comments")`
>
> Restrict the listing to posts ('links'), comments, or chat comments.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List popular subreddits
>
> **Slug:** `REDDIT_LIST_POPULAR_SUBREDDITS`
>
> List communities in Reddit's current activity-based popular ordering.
>
> #### Input Parameters
>
> **show** `string`
>
> Set to 'all' to include subreddits Reddit would otherwise filter from the listing.
>
> **after** `string`
>
> Fullname cursor from data.after used to fetch the next page.
>
> **count** `integer`
>
> Number of subreddits already seen, used by Reddit to number paginated listings.
>
> **limit** `integer`
>
> Maximum number of subreddits to return (1-100).
>
> **before** `string`
>
> Fullname cursor from data.before used to fetch the previous page.
>
> **sr\_detail** `boolean`
>
> Whether to expand subreddit details in the response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List subreddit comments
>
> **Slug:** `REDDIT_LIST_SUBREDDIT_COMMENTS`
>
> List recent comments across all posts in a subreddit. Use `data.after` as `after` on the next call to continue pagination. This is a subreddit-wide feed, not the comment tree for one post.
>
> #### Input Parameters
>
> **show** `string`
>
> Set to 'all' to include comments Reddit would otherwise filter from the listing.
>
> **after** `string`
>
> Fullname cursor from data.after used to fetch the next page.
>
> **count** `integer`
>
> Number of items already seen, used by Reddit to number paginated listings.
>
> **limit** `integer`
>
> Maximum number of comments to return (1-100).
>
> **before** `string`
>
> Fullname cursor from data.before used to fetch the previous page.
>
> **sr\_detail** `boolean`
>
> Whether to expand subreddit details in each returned comment.
>
> **subreddit** `string` *required*
>
> Subreddit name without the 'r/' prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List subreddit moderators
>
> **Slug:** `REDDIT_LIST_SUBREDDIT_MODERATORS`
>
> List a subreddit's moderators and each moderator's granted permissions.
>
> #### Input Parameters
>
> **show** `string`
>
> Set to 'all' to include moderators Reddit would otherwise filter from the listing.
>
> **user** `string`
>
> Filter or jump to one moderator username.
>
> **after** `string`
>
> Fullname cursor from a paginated response, when supplied by Reddit.
>
> **count** `integer`
>
> Number of moderator entries already seen.
>
> **limit** `integer`
>
> Requested page size (1-100); Reddit may return the complete roster.
>
> **before** `string`
>
> Previous-page fullname cursor, when supplied by Reddit.
>
> **sr\_detail** `boolean`
>
> Whether to expand subreddit details in the response.
>
> **subreddit** `string` *required*
>
> Subreddit name without the 'r/' prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List subreddit post flairs
>
> **Slug:** `REDDIT_LIST_SUBREDDIT_POST_FLAIRS`
>
> List available link/post flairs for a subreddit (including flair\_template\_id) so posts can satisfy flair-required validation. Use when you need to discover valid flair IDs before creating a post in a subreddit that requires flair. Note: Reddit may return empty or deny access if the authenticated user cannot set link flair and is not a moderator.
>
> #### Input Parameters
>
> **subreddit** `string` *required*
>
> The name of the subreddit (without 'r/' prefix) for which to retrieve available post/link flairs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List subreddit wiki pages
>
> **Slug:** `REDDIT_LIST_SUBREDDIT_WIKI_PAGES`
>
> List the visible wiki page names available in a subreddit.
>
> #### Input Parameters
>
> **subreddit** `string` *required*
>
> Subreddit name without the r/ prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List subscribed subreddits
>
> **Slug:** `REDDIT_LIST_SUBSCRIBED_SUBREDDITS`
>
> List communities subscribed to by the connected Reddit account.
>
> #### Input Parameters
>
> **show** `string`
>
> Set to 'all' to include communities Reddit would otherwise filter.
>
> **after** `string`
>
> Fullname cursor from data.after used to fetch the next page.
>
> **count** `integer`
>
> Number of communities already seen in the paginated listing.
>
> **limit** `integer`
>
> Maximum number of subscribed communities to return (1-100).
>
> **before** `string`
>
> Fullname cursor from data.before used to fetch the previous page.
>
> **sr\_detail** `boolean`
>
> Whether to expand subreddit details in the response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List user activity
>
> **Slug:** `REDDIT_LIST_USER_ACTIVITY`
>
> List a Reddit user's overview, posts, comments, or account-history views. History views include upvoted, downvoted, hidden, saved, and gilded content; Reddit returns private history only when the connected account may access it. Use `data.after` as `after` on the next call to continue pagination.
>
> #### Input Parameters
>
> **show** `string`
>
> Set to 'given' to show only explicitly requested content.
>
> **sort** `string ("hot" | "new" | "top" | "controversial")`
>
> Order in which Reddit returns the user's activity.
>
> **after** `string`
>
> Fullname cursor from data.after used to fetch the next page.
>
> **count** `integer`
>
> Number of items already seen, used by Reddit to number paginated listings.
>
> **limit** `integer`
>
> Maximum number of activity items to return (1-100).
>
> **before** `string`
>
> Fullname cursor from data.before used to fetch the previous page.
>
> **context** `integer`
>
> Number of parent comments to include for each comment result (2-10).
>
> **username** `string` *required*
>
> Reddit username without the 'u/' prefix.
>
> **sr\_detail** `boolean`
>
> Whether to expand subreddit details in each returned item.
>
> **time\_filter** `string ("hour" | "day" | "week" | "month" | "year" | "all")`
>
> Time window applied to top or controversial sorting.
>
> **content\_type** `string ("links" | "comments")`
>
> Restrict results to posts ('links') or comments.
>
> **activity\_type** `string ("overview" | "submitted" | "comments" | "upvoted" | "downvoted" | "hidden" | "saved" | "gilded")` *required*
>
> User activity view to list. Overview mixes posts and comments; submitted and comments select authored content; the other views select account history.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mark all inbox messages read
>
> **Slug:** `REDDIT_MARK_ALL_INBOX_MESSAGES_READ`
>
> Queue Reddit to mark all inbox items, or selected item types, as read.
>
> #### Input Parameters
>
> **filter\_types** `string`
>
> Optional comma-separated Reddit inbox item types to mark read, such as 'activity,messages'. Omit to mark every type read.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Post a comment
>
> **Slug:** `REDDIT_POST_REDDIT_COMMENT`
>
> Posts a comment on Reddit, replying to an existing submission (post) or another comment. Fails if the target thread is locked, archived, or restricted — verify thread state beforehand. Rapid successive calls trigger Reddit RATELIMIT errors with explicit cooldown hints (e.g., 'take a break for 9 minutes'); honor the specified wait before retrying. A successful API response does not guarantee public visibility — automod or spam filters may silently remove the comment. Publishes immediately and publicly; confirm target and text before executing.
>
> #### Input Parameters
>
> **text** `string` *required*
>
> REQUIRED. The raw Markdown text of the comment to be submitted. This field must be provided and cannot be empty.
>
> **thing\_id** `string` *required*
>
> REQUIRED. The ID of the parent post (link) or comment, prefixed with 't3\_' for a post (e.g., 't3\_10omtdx') or 't1\_' for a comment (e.g., 't1\_h2g9w8l'). This field must be provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Prepare Reddit media upload
>
> **Slug:** `REDDIT_PREPARE_MEDIA_UPLOAD`
>
> Registers an image or video with Reddit and returns temporary upload instructions. This does not upload the file or publish a post. Pass every returned upload field and its value unchanged to the upload destination before the temporary signature expires.
>
> #### Input Parameters
>
> **filename** `string` *required*
>
> Filename, including its extension, for the image or video to upload. Provide only a filename, not a local path.
>
> **mime\_type** `string ("image/jpeg" | "image/png" | "video/mp4" | "video/quicktime")` *required*
>
> Reddit-supported MIME type matching the media file.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve Comments for a Post
>
> **Slug:** `REDDIT_RETRIEVE_POST_COMMENTS`
>
> Retrieves a Reddit post and its comments by article ID, with optional sort, limit and depth. Returns `post_listing` and `comments_listing`, including nested replies and possible `more` placeholders; comment trees may be truncated.
>
> #### Input Parameters
>
> **sort** `string ("confidence" | "top" | "new" | "controversial" | "old" | "random" | "qa" | "live")`
>
> Comment sort order. Valid values: confidence (default, 'best'), top, new, controversial, old, random, qa, live. If omitted, Reddit uses the subreddit's or user's default sort.
>
> **depth** `integer`
>
> Maximum nesting depth of the comment tree to return. Deeper replies are collapsed into 'more' placeholders instead of being expanded. Reddit's docs don't state a fixed bound.
>
> **limit** `integer`
>
> Maximum number of comments to return. Reddit's docs don't state a fixed bound for this endpoint; omit to use Reddit's own default.
>
> **article** `string` *required*
>
> Base-36 ID of the Reddit post (e.g., 'q5u7q5'), typically found in the post's URL and not including the 't3\_' prefix.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve posts from subreddit
>
> **Slug:** `REDDIT_RETRIEVE_REDDIT_POST`
>
> Retrieve a paginated listing of posts from a specified subreddit, with sort options and a time-period filter for top or controversial posts. Post data is nested under `data.children[].data`; use `data.after` to continue pagination.
>
> #### Input Parameters
>
> **show** `string`
>
> Display filtering option. Use 'all' to include items Reddit would normally omit, such as hidden posts.
>
> **sort** `string ("hot" | "new" | "top" | "rising" | "controversial")`
>
> Sort order for posts. Options: 'hot' (default, most active posts), 'new' (newest first), 'top' (highest scoring), 'rising' (trending posts), 'controversial' (most controversial).
>
> **after** `string`
>
> Fullname of a thing to use as an anchor for pagination. Returns results after this fullname.
>
> **count** `integer`
>
> Number of items already seen, used by Reddit to number paginated listings.
>
> **before** `string`
>
> Fullname of a thing to use as an anchor for pagination. Returns results before this fullname.
>
> **sr\_detail** `boolean`
>
> Whether to expand subreddit details in the response.
>
> **subreddit** `string` *required*
>
> The name of the subreddit from which to retrieve posts (e.g., 'popular', 'pics'). Do not include 'r/'. Subreddit names must be 3-21 characters and can only contain letters, numbers, and underscores.
>
> **max\_results** `integer`
>
> The maximum number of posts to return. Default is 5. Set to 0 to retrieve the maximum allowed by the Reddit API (100 posts). Valid range: 0-100.
>
> **time\_filter** `string ("hour" | "day" | "week" | "month" | "year" | "all")`
>
> Time period to filter posts by, only meaningful when sort='top' or sort='controversial' (e.g. 'top posts of the week'). Ignored for other sort values. Options: 'hour', 'day', 'week', 'month', 'year', 'all'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve specific comment or post
>
> **Slug:** `REDDIT_RETRIEVE_SPECIFIC_COMMENT`
>
> Retrieves selected details for a Reddit comment or post by fullname, without surrounding thread context. An empty listing raises an error; returned items may have partial details.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Reddit fullname identifier. Format: type prefix (t1\_ for comments, t3\_ for posts) followed by a base36 ID. Examples: 't1\_abc123', 't3\_1abc2de'. Note: Share URL tokens from reddit.com/r/.../s/... links are NOT valid fullnames and cannot be used directly. Note: REDDIT\_RETRIEVE\_POST\_COMMENTS expects the bare base-36 ID without the t3\_ prefix, unlike this tool.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search across subreddits
>
> **Slug:** `REDDIT_SEARCH_ACROSS_SUBREDDITS`
>
> Searches Reddit for posts using a query, returning a streamlined `posts` array and pagination cursors. An optional time filter restricts the period; a nonempty result type selection must include `link`, and non-post matches are omitted.
>
> #### Input Parameters
>
> **sort** `string ("relevance" | "hot" | "new" | "top" | "comments")`
>
> The criterion for sorting search results. 'relevance' (default) sorts by relevance to the query. 'hot' sorts by trending posts with recent upvotes and activity. 'new' sorts by newest first. 'top' sorts by highest score (typically all-time). 'comments' sorts by the number of comments.
>
> **after** `string`
>
> Pagination cursor to fetch the next page of results. Use the `after` value from the previous response to get subsequent results.
>
> **limit** `integer`
>
> The maximum number of search results to return. Default is 5. Maximum allowed value is 100. Paginate beyond the first page using the `after` cursor from `data.after` in the response; deduplicate results across pages by post `id`.
>
> **before** `string`
>
> Pagination cursor to fetch the previous page of results. Use the `before` value from the previous response to get preceding results.
>
> **restrict\_sr** `boolean`
>
> If True (default), confines the search to posts and comments within subreddits. If False, the search scope is broader and may include matching subreddit names or other Reddit entities.
>
> **result\_type** `array`
>
> Restrict results to specific content types: 'sr' (subreddits), 'link' (posts), and 'user' (users). Because this action returns posts only, result\_type must include 'link'; non-post matches in mixed searches are omitted. Use GET\_SUBREDDITS\_SEARCH for subreddit-only search.
>
> **time\_filter** `string ("hour" | "day" | "week" | "month" | "year" | "all")`
>
> Restrict results to this time period: hour, day, week, month, year, or all. If omitted, Reddit applies its own default (typically 'all' for relevance sort).
>
> **search\_query** `string` *required*
>
> The search query string. Supports Reddit search operators: 'title:', 'author:', 'subreddit:', 'url:', 'site:', 'flair:', 'self:yes/no', 'nsfw:yes/no', and boolean operators (AND, OR, NOT). Raw URLs (starting with http\:// or https\://) are not allowed - use the 'url:' or 'site:' operators instead (e.g., 'url:example.com' to find posts linking to that domain).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Send private message
>
> **Slug:** `REDDIT_SEND_PRIVATE_MESSAGE`
>
> Send a private Reddit message immediately; sending cannot be undone.
>
> #### Input Parameters
>
> **text** `string` *required*
>
> Message body in Reddit Markdown.
>
> **subject** `string` *required*
>
> Message subject, at most 100 characters.
>
> **recipient** `string` *required*
>
> Reddit username without u/, or r/community to message a subreddit's moderators.
>
> **from\_subreddit** `string`
>
> Subreddit to send on behalf of when the connected account has permission.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Enable or disable inbox replies
>
> **Slug:** `REDDIT_TOGGLE_INBOX_REPLIES`
>
> Enable or disable inbox replies for a submission or comment. Use when you want to control whether you receive inbox notifications for replies to your own posts or comments.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The fullname of a thing created by the user. Must be prefixed with the thing type (e.g., 't3\_' for a submission/post, 't1\_' for a comment). Example: 't3\_abc123' for a post.
>
> **state** `boolean` *required*
>
> Boolean value to enable or disable inbox replies. Set to true to enable receiving inbox notifications when users reply to this thing, or false to disable inbox notifications.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Vote on Reddit content
>
> **Slug:** `REDDIT_VOTE_ON_CONTENT`
>
> Cast or clear one vote only when directly instructed by a human. Never infer how to vote, vote autonomously, amplify a vote, or apply one instruction to multiple items.
>
> #### Input Parameters
>
> **rank** `integer`
>
> Optional positive rank of the content in the listing where the vote was cast.
>
> **thing\_id** `string` *required*
>
> Fullname of the Reddit post (t3\_) or comment (t1\_) the human explicitly instructed you to vote on.
>
> **direction** `integer ("-1" | "0" | "1")` *required*
>
> Human-directed vote: 1 upvotes, -1 downvotes, and 0 clears the connected user's vote. Do not infer or choose a vote; use only the direction the human directly instructed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
