# Reddit Reddit is a social news platform with user-driven communities (subreddits), offering content sharing, discussions, and viral marketing opportunities for brands - **Category:** social media accounts - **Auth:** OAUTH2 - **Composio Managed App Available?** Yes - **Tools:** 23 - **Triggers:** 0 - **Slug:** `REDDIT` - **Version:** 20260414_00 ## Tools ### Create a Reddit post **Slug:** `REDDIT_CREATE_REDDIT_POST` Creates a new text or link post on a specified, existing Reddit subreddit, optionally applying a flair. Immediately publishes publicly visible content — confirm subreddit, title, and body with the user before executing. Posts may be silently removed post-submission by automoderator or subreddit rules (errors: SUBMIT_VALIDATION_BODY_BLACKLISTED_STRING, POST_GUIDANCE_VALIDATION_FAILED); verify visibility via the returned permalink. Rapid consecutive calls trigger RATELIMIT errors with cooldown hints. ### 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. ### 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. ### 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. ### Get Reddit listing by sort **Slug:** `REDDIT_GET` Tool to retrieve a listing of Reddit posts sorted by the specified criteria (hot, new, top, etc.). 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/controversial sorts. ### 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. ### 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. ### 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. ### Get random Reddit post **Slug:** `REDDIT_GET_RANDOM` Tool to retrieve a random public Reddit post from any subreddit. Use when you want to discover serendipitous content or need a random post for testing or entertainment purposes. ### 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. ### Get top posts from subreddit **Slug:** `REDDIT_GET_R_TOP` 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. ### 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. ### 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. ### 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. ### 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. ### 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. ### 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. ### 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. ### Retrieve Comments for a Post **Slug:** `REDDIT_RETRIEVE_POST_COMMENTS` Retrieves all comments for a Reddit post given its base-36 article ID. Response is a two-element listings array: post metadata in `listings[0]`; comments in `listings[1].data.children` with text at each `[].data.body` and nested replies under each comment's `replies` field. Replies require recursive traversal to capture full discussion. Large, locked, or archived threads may return truncated trees or `more` placeholders rather than full results. Filter out comments where `body` is `[deleted]` or `[removed]`; use `parent_id` to reconstruct conversation flow. No time-filter parameter — compare `created_utc` against a UTC cutoff to filter by date. ### Retrieve posts from subreddit **Slug:** `REDDIT_RETRIEVE_REDDIT_POST` Retrieves posts from a specified, publicly accessible subreddit. Responses nest post data under `data.children[].data`; inspect the structure before parsing. Pagination uses a `data.after` cursor; deduplicate across pages by post `id`. No built-in date filtering; compare `created_utc` (Unix seconds, UTC) client-side. Rate limit: ~1–2 requests/second; back off on HTTP 429. ### Retrieve specific comment or post **Slug:** `REDDIT_RETRIEVE_SPECIFIC_COMMENT` Retrieves detailed information for a single Reddit comment or post using its fullname. Returns only the specified item, not surrounding thread context; use REDDIT_RETRIEVE_POST_COMMENTS for full discussion retrieval. Deleted, removed, or quarantined items may return empty or partial payloads. ### Search across subreddits **Slug:** `REDDIT_SEARCH_ACROSS_SUBREDDITS` Searches Reddit for posts/comments using a query. Results nested under `data.children[i].data` (kind `t3` for posts); a `posts` array may also appear — inspect actual response path. No native time-range filter; compare `created_utc` (Unix epoch, UTC) client-side for recency filtering. Empty `children` is a valid no-results outcome. Key post fields: `score`, `num_comments`, `created_utc`, `permalink`. Rate limit: ~1–2 requests/sec; HTTP 429 indicates throttling. ### 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.