- Category: social media accounts
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 36
- Triggers: 0
- Slug:
REDDIT - Version: 20261101_00
Tools
Create a Reddit post
Create a Reddit post
REDDIT_CREATE_REDDIT_POSTCreates 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
kind is ‘self’. Body must not exceed ~40,000 characters.Output
Delete Reddit comment
Delete Reddit comment
REDDIT_DELETE_REDDIT_COMMENTDeletes a Reddit comment, identified by its fullname ID, if it was authored by the authenticated user. Deletion is permanent and irreversible.Input Parameters
Output
Delete a Reddit post
Delete a Reddit post
REDDIT_DELETE_REDDIT_POSTPermanently 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
Output
Edit comment or post
Edit comment or post
REDDIT_EDIT_REDDIT_COMMENT_OR_POSTEdits the body text of the authenticated user’s own existing comment or self-post on Reddit; cannot edit link posts or titles.Input Parameters
Output
Expand More Comments
Expand More Comments
REDDIT_EXPAND_MORE_COMMENTSResolve 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
Output
Get Reddit listing by sort
Get Reddit listing by sort
REDDIT_GETTool 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
Output
Get controversial posts from all subreddits
Get controversial posts from all subreddits
REDDIT_GET_CONTROVERSIAL_POSTSTool 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
Output
Get inbox message
Get inbox message
Get user preferences
Get user preferences
REDDIT_GET_ME_PREFSTool to retrieve preference settings of the logged in user. Use when you need to check user preferences or settings.Input Parameters
Output
Get modmail conversation
Get modmail conversation
Get new posts from subreddit (Deprecated)
Get new posts from subreddit (Deprecated)
REDDIT_GET_NEWDEPRECATED: 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
Output
Get Reddit posts by fullname
Get Reddit posts by fullname
Get random Reddit post
Get random Reddit post
REDDIT_GET_RANDOMRetrieve 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
Output
Get user information
Get user information
REDDIT_GET_REDDIT_USER_ABOUTRetrieves 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
Output
Get top posts from subreddit (Deprecated)
Get top posts from subreddit (Deprecated)
REDDIT_GET_R_TOPDEPRECATED: 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
Output
Get OAuth scopes
Get OAuth scopes
Get subreddit metadata
Get subreddit metadata
Get subreddit rules
Get subreddit rules
REDDIT_GET_SUBREDDIT_RULESFetch 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
Output
Search subreddits
Search subreddits
REDDIT_GET_SUBREDDITS_SEARCHTool 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
Output
Get Reddit user comments RSS
Get Reddit user comments RSS
Get user flair
Get user flair
REDDIT_GET_USER_FLAIRFetches 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
Output
Check username availability
Check username availability
REDDIT_GET_USERNAME_AVAILABLETool 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
Output
Get subreddit wiki page
Get subreddit wiki page
REDDIT_GET_WIKI_PAGERetrieve a subreddit wiki page’s rendered and Markdown content, optionally at a historical revision or as a comparison between two revisions.Input Parameters
Output
List custom Reddit feed
List custom Reddit feed
List inbox messages
List inbox messages
List inbox mentions
List inbox mentions
List moderation queue
List moderation queue
REDDIT_LIST_MODERATION_QUEUEList 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
Output
List popular subreddits
List popular subreddits
List subreddit comments
List subreddit comments
List subreddit moderators
List subreddit moderators
List subreddit post flairs
List subreddit post flairs
REDDIT_LIST_SUBREDDIT_POST_FLAIRSList 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
Output
List subreddit wiki pages
List subreddit wiki pages
List subscribed subreddits
List subscribed subreddits
List user activity
List user activity
REDDIT_LIST_USER_ACTIVITYList 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
Output
Mark all inbox messages read
Mark all inbox messages read
Post a comment
Post a comment
REDDIT_POST_REDDIT_COMMENTPosts 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
Output
Prepare Reddit media upload
Prepare Reddit media upload
REDDIT_PREPARE_MEDIA_UPLOADRegisters 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
Output
Retrieve Comments for a Post
Retrieve Comments for a Post
REDDIT_RETRIEVE_POST_COMMENTSRetrieves 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
Output
Retrieve posts from subreddit
Retrieve posts from subreddit
REDDIT_RETRIEVE_REDDIT_POSTRetrieve 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
Output
Retrieve specific comment or post
Retrieve specific comment or post
REDDIT_RETRIEVE_SPECIFIC_COMMENTRetrieves 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
Output
Search across subreddits
Search across subreddits
REDDIT_SEARCH_ACROSS_SUBREDDITSSearches 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
after value from the previous response to get subsequent results.after cursor from data.after in the response; deduplicate results across pages by post id.before value from the previous response to get preceding results.Output
Send private message
Send private message
Enable or disable inbox replies
Enable or disable inbox replies
REDDIT_TOGGLE_INBOX_REPLIESEnable 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
Output
Vote on Reddit content
Vote on Reddit content
REDDIT_VOTE_ON_CONTENTCast 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.