Reddit

What your agents can do

Helios agents don't work from a preset list of actions. They semantically search the entire Reddit API and call any endpoint directly, with authentication handled server-side. Anything your Reddit account and app scopes allow, an agent can do on your behalf.

• Search subreddits and posts and summarize what's trending
• Submit a post or comment to a subreddit
• Pull a user's or subreddit's recent activity
• Vote, save, and manage flair on content
• Run moderation actions (approve, remove, ban) in subreddits you moderate
• Read and send private messages

Authentication

Helios Reddit App (Recommended)

The Helios Reddit App connects through a standard OAuth redirect flow with automatic permission management. Choose it in Helios, authorize access to your Reddit account, and Helios handles token refresh for you.

BYO Reddit App

Bring your own Reddit application for enterprise requirements or custom permission management.

Setup Steps

1. Create the Reddit App

   • Go to Reddit App Preferences
   • Click Create App or Create Another App
   • Important: Choose web app (this is required for OAuth flow)
   • Fill in the app details:
     • Name: Your app name (e.g., "MyHeliosApp")
     • Description: Brief description of your app
     • About URL: Optional URL with information about your app
     • Redirect URI: Set to your OAuth callback URL (e.g., https://your-app.com/auth/reddit/callback)
   • Click Create app
   • Copy the Client ID (displayed under the app name) and Client Secret

2. Generate Access and Refresh Tokens

   • Direct users to the authorization URL:

     https://www.reddit.com/api/v1/authorize?client_id=YOUR_CLIENT_ID&response_type=code&state=RANDOM_STRING&redirect_uri=YOUR_REDIRECT_URI&duration=permanent&scope=REQUIRED_SCOPES

   • After user authorization, Reddit will redirect to your callback URL with an authorization code
   • Exchange the authorization code for access and refresh tokens:

     POST https://www.reddit.com/api/v1/access_token

   • Include the authorization code, client ID, client secret, and redirect URI in the request
   • Save both the access token (short-lived) and refresh token (for token renewal)

3. Configure in Helios

   • Client ID: The client ID from your Reddit app
   • Client Secret: The client secret from your Reddit app
   • Access Token: The access token obtained from the OAuth flow
   • Refresh Token: The refresh token for automatic token renewal
   • App Name: Your app identifier in format MyHeliosApp:v1.0.0 (used for Reddit API requests)
   • Username: Your Reddit username in format /u/heliosuser (the account associated with the app)
   • Helios will automatically handle token refresh when needed

Common OAuth Scopes

• identity - Access to account information
• read - Read posts and comments
• submit - Submit posts and comments
• edit - Edit and delete posts and comments
• vote - Submit and change votes on posts and comments
• save - Save and unsave posts and comments
• history - Access to post and comment history
• flair - Manage user and link flair
• subscribe - Subscribe/unsubscribe from subreddits
• mysubreddits - Access to subscribed and moderated subreddits
• privatemessages - Access to private messages
• report - Report posts and comments
• account - Access to account settings
• modposts - Approve/remove posts and comments
• modflair - Manage user and link flair in moderated subreddits
• modmail - Access moderator mail
• modconfig - Manage subreddit configuration and rules

Triggers

Reddit does not currently emit event triggers into Helios. Use it from Chat, or from a Workflow driven by a schedule, webhook, or manual run.