Get your Reddit Credentials
To use Reddit sign in, you need a client ID and client secret. You can get them from the Reddit Developer Portal.
- Click "Create App" or "Create Another App"
- Select "web app" as the application type
- Set the redirect URL to
http://localhost:3000/api/auth/callback/redditfor local development - For production, set it to your application's domain (e.g.
https://example.com/api/auth/callback/reddit) - After creating the app, you'll get the client ID (under the app name) and client secret
If you change the base path of the auth routes, make sure to update the redirect URL accordingly.
Configure the provider
To configure the provider, you need to import the provider and pass it to the social_providers option of the auth instance.
require "better_auth"
auth = BetterAuth.auth(
secret: ENV.fetch("BETTER_AUTH_SECRET"),
base_url: ENV.fetch("BETTER_AUTH_URL", "http://localhost:3000"),
social_providers: {
reddit: BetterAuth::SocialProviders.reddit(
client_id: ENV.fetch("REDDIT_CLIENT_ID"),
client_secret: ENV.fetch("REDDIT_CLIENT_SECRET")
)
}
)Sign In with Reddit
To sign in with Reddit, call auth.api.sign_in_social on your Ruby auth instance. The endpoint body takes the following properties:
provider: The provider to use. It should be set toreddit.
response = auth.api.sign_in_social(
body: {
provider: "reddit",
callback_url: "/dashboard",
error_callback_url: "/login",
disable_redirect: true
}
)
redirect_url = response.fetch(:url)Additional Configuration
Scopes
By default, Reddit provides basic user information. If you need additional permissions, you can specify scopes in your auth configuration:
require "better_auth"
auth = BetterAuth.auth(
secret: ENV.fetch("BETTER_AUTH_SECRET"),
base_url: ENV.fetch("BETTER_AUTH_URL", "http://localhost:3000"),
social_providers: {
reddit: BetterAuth::SocialProviders.reddit(
client_id: ENV.fetch("REDDIT_CLIENT_ID"),
client_secret: ENV.fetch("REDDIT_CLIENT_SECRET"),
duration: "permanent"
)
}
)Common Reddit scopes include:
identity: Access basic account informationread: Access posts and commentssubmit: Submit posts and commentssubscribe: Manage subreddit subscriptionshistory: Access voting history
For a complete list of available scopes, refer to the Reddit OAuth2 documentation.