Reddit

Authentication

✅ Helios Reddit App (Recommended)

The Helios Reddit App provides seamless integration with automatic permission management and secure OAuth flow.

BYO Reddit App

Create 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
• edit - Edit and delete posts and comments
• flair - Manage user and link flair
• history - Access to post and comment history
• modconfig - Manage subreddit configuration and rules
• modflair - Manage user and link flair in moderated subreddits
• modlog - Access to moderation log
• modposts - Approve/remove posts and comments
• modself - Accept moderator invitations
• modwiki - Manage wiki pages in moderated subreddits
• mysubreddits - Access to subscribed and moderated subreddits
• privatemessages - Access to private messages
• read - Read posts and comments
• report - Report posts and comments
• save - Save and unsave posts and comments
• submit - Submit posts and comments
• subscribe - Subscribe/unsubscribe from subreddits
• vote - Submit and change votes on posts and comments
• wikiedit - Edit wiki pages
• wikiread - Read wiki pages

Functionality

The Reddit integration lets your workflows manage subreddits, automate content creation, handle community moderation, and engage with Reddit's community platform without writing custom code.

API Versions

The integration supports the Reddit API:

Reddit API (OAuth 2.0)

Current stable API version with full feature support for content management and community interaction.

Data Retrieval

Rate Limits

Reddit API has rate limiting in place:

• OAuth requests: 60 requests per minute
• Read operations: Higher limits for GET requests
• Write operations: Lower limits for POST/PUT/DELETE requests