Marketing & Social Media

Reddit

Learn how to use Reddit with Composio

Overview

SLUG

REDDIT

Description

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

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to identity read vote submit flair edit
full
stringDefaults to https://oauth.reddit.com
bearer_token
string

Tools

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.

Action Parameters

text
stringRequired
thing_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REDDIT_CREATE_REDDIT_POST

Creates a new text or link post on a specified, existing reddit subreddit, optionally applying a flair.

Action Parameters

flair_id
stringRequired
kind
stringRequired
subreddit
stringRequired
text
string
title
stringRequired
url
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REDDIT_DELETE_REDDIT_COMMENT

Deletes a reddit comment, identified by its fullname id, if it was authored by the authenticated user.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REDDIT_DELETE_REDDIT_POST

Permanently deletes a reddit post by its id, provided the authenticated user has deletion permissions for that post.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REDDIT_POST_REDDIT_COMMENT

Posts a comment on reddit, replying to an existing and accessible submission (post) or another comment.

Action Parameters

text
stringRequired
thing_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REDDIT_RETRIEVE_POST_COMMENTS

Retrieves all comments for a reddit post given its article id (which must be for an existing, public post); nested replies within comments are returned as raw dictionaries requiring parsing.

Action Parameters

article
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REDDIT_RETRIEVE_REDDIT_POST

Retrieves the current hot posts from a specified, publicly accessible subreddit.

Action Parameters

size
integerDefaults to 5
subreddit
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REDDIT_RETRIEVE_SPECIFIC_COMMENT

Retrieves detailed information for a specific reddit comment or post using its fullname.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: REDDIT_SEARCH_ACROSS_SUBREDDITS

Searches reddit for content (e.g., posts, comments) using a query, with results typically confined to subreddits unless `restrict sr` is set to false.

Action Parameters

limit
integerDefaults to 5
restrict_sr
booleanDefaults to True
search_query
stringRequired
sort
stringDefaults to relevance

Action Response

data
objectRequired
error
string
successful
booleanRequired