Skip to main content

Prerequisites

You need a Reddit account that can create apps.

  • A Reddit account with no app-creation restrictions.
  • Permission to create apps.

Create OAuth application

Register a Web app in Reddit’s app preferences.

1

Open the apps page

Sign in to Reddit, click your profile icon, then click Settings.

  • On the Account tab, under Apps, click OAuth app settings.
  • Scroll to the bottom of the page.
  • Click are you a developer? create an app… to open the form.
2

Fill out app details

Provide the app metadata.

  • app name: StackOne Integration
  • Select the web app radio button.
  • description: a short summary of your integration
  • redirect uri: the Callback URL from your Connector Profile
  • Click create app.
3

Copy credentials

After creation the new app card shows the credentials you need.

  • Copy the string under the app name (just below “web app”) into your Connector Profile as the Client ID.
  • Click edit next to the app, then copy the secret into your Connector Profile as the Client Secret.

Permissions

Reddit has no permission screen in the app settings. The permissions below are the ones the connector asks for, and Reddit lists them on the authorization screen each end user sees when they connect their account.

1

Review the permissions requested

Enables actions: Approve Thing, Ban User, Block User, Check Username Availability, Compose Message, Delete Comment, Delete Message, Delete Post, Edit Comment, Edit Post, Edit Wiki Page, Get Me, Get More Children, Get My Karma, Get My Preferences, Get My Trophies, Get Post, Get Subreddit About, Get Subreddit Rules, Get Unread Count, Get User About, Get User Trophies, Get Wiki Page, List Hot Posts, List Inbox, List Mod Queue, List My Friends, List My Moderated Subreddits, List My Subscribed Subreddits, List New Posts, List Popular Subreddits, List Post Comments, List Sent Messages, List Subreddit Comments, List Subreddit Hot Posts, List Subreddit New Posts, List Top Posts, List Unread Messages, List User Comments, List User Submitted, List Wiki Pages, Read All Messages, Read Message, Remove Thing, Save Thing, Search All Of Reddit, Search Subreddits, Search Users, Search Within Subreddit, Submit Comment, Submit Post, Subscribe To Subreddit, Unban User, Unsave Thing, Unsubscribe From Subreddit, Update My Preferences, Vote On Thing

Reddit shows these permissions on the authorization screen. The user must approve them for the connected account.

Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.