Reddit integration

What it does

The Reddit integration lets your agency listen to and take part in Reddit communities on behalf of your clients. Connect a client's Reddit account once and your workflows can watch a subreddit, a search for a brand name, a user's activity or the account's inbox, then reply, post, crosspost, send private messages, save content, join subreddits and moderate communities the account runs.

Connect a Reddit account

Reddit only issues API access through an app registered on a Reddit account, so connecting takes two steps.

1. Register a Reddit app for your agency at reddit.com/prefs/apps. Choose the web app type and set the redirect URI to the exact URL TaskJuice shows on the OAuth client form. Reddit reviews new API apps under its Responsible Builder policy, so allow time for approval.
2. In TaskJuice, open Settings, then Integrations, then OAuth clients, and add the Reddit app's client ID. Tick the scopes your workflows need.
3. Open your workspace, navigate to Apps, choose Reddit and click Connect account.
4. Sign in with the Reddit account that will act for your client and approve the requested permissions.

TaskJuice requests a permanent grant, so the connection keeps working after Reddit's one-hour access tokens expire. To revoke access, open Reddit's app preferences while signed in as that account and revoke the TaskJuice entry.

Triggers

Every Reddit trigger polls on a schedule and fires one run per cycle with an items array of everything new since the last cycle. Add a Loop node to handle each item on its own. Content that already exists when you publish the workflow never fires.

Actions

Posts

• reddit/submit-post submits a text or link post, with an optional post flair picked from the subreddit's flairs, NSFW and spoiler tags.
• reddit/crosspost-post shares an existing post into another subreddit.
• reddit/get-post fetches a post or comment by its fullname.
• reddit/list-subreddit-posts lists a subreddit's Hot, New, Top, Rising or Controversial posts.
• reddit/search-posts searches posts in one subreddit or across Reddit.
• reddit/list-user-submissions lists posts a user has submitted.
• reddit/edit-post-or-comment replaces the text of a text post or comment.
• reddit/delete-post permanently deletes a post the account submitted.

Comments

• reddit/submit-comment comments on a post or replies to a comment.
• reddit/list-post-comments returns a post and its comment tree.
• reddit/list-subreddit-comments lists the newest comments in a subreddit.
• reddit/list-user-comments lists a user's comments.
• reddit/delete-comment permanently deletes a comment the account wrote.

Inbox

• reddit/send-private-message sends a private message to a user or to a subreddit's moderators.
• reddit/list-inbox-messages lists the inbox, unread items, private messages, sent messages, mentions or comment replies without marking them read.
• reddit/mark-message-read marks inbox items as read.

Subreddits

• reddit/get-subreddit returns a subreddit's title, description and subscriber count.
• reddit/get-subreddit-rules returns a subreddit's posting rules.
• reddit/search-subreddits finds subreddits by keyword.
• reddit/list-my-subreddits lists subreddits the account has joined, is approved in or moderates.
• reddit/list-link-flairs lists a subreddit's post flairs.
• reddit/subscribe-subreddit joins a subreddit.
• reddit/unsubscribe-subreddit leaves a subreddit, picked from the ones the account has joined.

Users and the connected account

• reddit/get-user returns a user's public profile and karma.
• reddit/get-current-user returns the connected account's profile.
• reddit/get-my-karma breaks the account's karma down by subreddit.
• reddit/get-my-trophies lists the account's trophies.
• reddit/get-my-preferences returns the account's Reddit preferences.
• reddit/list-friends lists users the account follows as friends.
• reddit/list-blocked-users lists users the account has blocked.
• reddit/list-saved-items lists the account's saved posts and comments.
• reddit/save-item and reddit/unsave-item add or remove a post or comment from the Saved list.

Moderation (subreddits the connected account moderates)

• reddit/remove-item removes a post or comment, optionally as spam.
• reddit/approve-item approves a post or comment, restoring it if it was removed.

Known limitations

• Reddit has no webhooks, so every trigger polls. Poll intervals default to 5 to 15 minutes. A busy subreddit can produce more than 100 new comments between polls; shorten the interval for those.
• Reddit answers many rejected writes (subreddit not found, flair required, posting too often, thread locked) with a success status and an error list. TaskJuice reads that list and fails the step with Reddit's own message.
• Reddit enforces 100 requests per minute per OAuth client. Every connection that uses your agency's Reddit app shares that budget.
• Image, video and gallery posts are not supported; they need a multi-step media upload that this integration does not perform. Submit a link post to share media hosted elsewhere.
• Reddit's search API returns posts, not comments, so there is no comment-search trigger. Watch a subreddit's comments and filter them in the workflow instead.
• Voting is not offered. Reddit's API rules allow votes only as a direct one-for-one action by a person, never from automation.
• Reddit only exposes the Saved list of the signed-in account, so New Saved Item and List Saved Items need that account's own username.
• Subreddit rules such as account-age minimums, karma floors and required flair still apply to every post and comment.