Reddit

Overview

Connect your users to Reddit for reading posts, submitting content, managing subscriptions, and community interactions.

Property	Value
Provider ID	reddit
Category	Social
PKCE	Supported
Token refresh	Automatic
Redirect URI	Shown in Developer Portal

Step 1: Create a Reddit OAuth App

Go to Reddit App Preferences

Navigate to reddit.com/prefs/apps and sign in.

Create a new app

Click are you a developer? create an app…. Select web app as the app type, enter the name, and fill in the description.

Configure the redirect URI

Enter the Alter callback URL from the Developer Portal in the redirect uri field.

Get credentials

Copy the Client ID (shown under the app name) and Client Secret.

Warning

Never share your Client Secret publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Reddit provider

Go to OAuth Providers > Add Provider > Reddit.

Enter credentials

• Client ID: Paste your Reddit Client ID
• Client Secret: Paste your Reddit Client Secret

Select scopes

Choose the scopes the application needs.

Save

Click Save. The provider is now active.

Available Scopes

Scope	Description
identity	View the user’s Reddit username and account information
read	Read posts, comments, and subreddit information
submit	Submit posts and comments
edit	Edit posts and comments
history	View the user’s voting and comment history
subscribe	Subscribe and unsubscribe from subreddits
vote	Upvote and downvote posts and comments
privatemessages	Read and send private messages
save	Save and unsave posts and comments
flair	Manage user and post flair
mysubreddits	View subreddits the user moderates or is subscribed to
report	Report posts and comments for rule violations
wikiread	Read subreddit wiki pages
wikiedit	Edit subreddit wiki pages
modposts	Approve, remove, and distinguish posts and comments as a moderator
modconfig	Manage subreddit configuration and settings as a moderator
modflair	Manage user and link flair in moderated subreddits
modothers	Invite and manage moderators and contributors

Notes

• Reddit access tokens expire after 1 hour. Alter Vault handles automatic token refresh.
• See the Reddit OAuth API documentation for more details.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
comment	send	POST	/api/comment
compose	send	POST	/api/compose
submit	send	POST	/api/submit
del	delete	POST	/api/del
editusertext	write	POST	/api/editusertext
info	read	GET	/api/info
me/get	read	GET	/api/v1/me
me/karma	read	GET	/api/v1/me/karma
me/prefs/get	read	GET	/api/v1/me/prefs
me/prefs/update	write	PATCH	/api/v1/me/prefs
message/inbox	read	GET	/message/inbox
subreddit/about	read	GET	/r/{subreddit}/about
subreddit/comments	read	GET	/r/{subreddit}/comments/{article}
subreddit/hot	read	GET	/r/{subreddit}/hot
subreddit/new	read	GET	/r/{subreddit}/new
subreddit/search	read	GET	/r/{subreddit}/search
subreddit/top	read	GET	/r/{subreddit}/top
subreddits/mine	read	GET	/subreddits/mine/subscriber
subscribe	write	POST	/api/subscribe
user/about	read	GET	/user/{username}/about
user/comments	read	GET	/user/{username}/comments
user/submitted	read	GET	/user/{username}/submitted
vote	write	POST	/api/vote