Connect Reddit to browse listings, create posts and comments, search, message, and moderate your communities.
You end up pasting the client id printed under your app's name on reddit.com/prefs/apps and the matching secret field from the same card.
Partner application before this connector works
Reddit's Data API Terms allow free use only for non-commercial purposes; any commercial use requires Reddit's prior written approval through its Data API access request, and paid commercial access is a signed agreement.
- Typical wait
- 2-4 weeks for commercial review, per consistent developer reports; Reddit does not publish an SLA
- Cost
- Free for approved non-commercial use. Reddit publishes no public rate card for commercial access - the widely-cited $0.24 per 1,000 API calls traces to Reddit's 2023 pricing announcement and is repeated across developer write-ups; enterprise bundles are reported in the thousands of dollars per month. Real pricing is quoted per deal after review.
- Blocked until approved
- Nothing technical is blocked on day one - the block is contractual. Using the free tier for brand monitoring, lead generation, competitor tracking, resale of Reddit content or any revenue-generating product breaches the Data API Terms and risks the client ID being revoked. Volume above the free 100 queries per minute per OAuth client also needs the agreement.
- Works meanwhile
- Registering an app at reddit.com/prefs/apps is instant and free: you get a client ID and secret straight away and can read posts, comments, subreddits and search, and post as the authorised user, at up to 100 queries per minute per OAuth client for personal, moderator, bot and academic use.
Where to apply: The Reddit Data API access request ticket form linked from the Reddit Data API Wiki in Reddit Help (support.reddithelp.com), choosing the developer, researcher or commercial category. App registration itself is at reddit.com/prefs/apps.
- Whether you need approval turns on use case, not call volume - a low-traffic commercial tool still counts as commercial.
- Requests without a descriptive, unique User-Agent string are throttled or blocked regardless of approval.
- Unauthenticated requests get a far lower rate limit than the 100 QPM OAuth allowance - always use OAuth.
- Commercial agreements come with content restrictions (NSFW exclusions, limits on historical data and on training models).
- Vague use-case descriptions in the access request are the main cause of long queues and rejections.
- Reddit has revoked keys retroactively for apps found to be operating commercially on the free tier.
- Setup time
- 5 min
- Auth
- OAuth authorization
- API base URL
- https://oauth.reddit.com
- Rate limits
- Free non-commercial use is capped at roughly 100 queries per minute per OAuth client id on a rolling window. Commercial use requires an approved paid agreement with Reddit.
Before you begin
- A Reddit account with a verified email address
- The app must be created as a web app, because only that type supports the browser authorization flow PopMCP uses
- Non-commercial use only on the free tier, since commercial use needs a separate paid agreement with Reddit
- Moderator status in a subreddit if you plan to use the mod scopes
Get your credentials
Open your Reddit app preferences
Sign in to Reddit and go to reddit.com/prefs/apps. Scroll past authorized applications to the developed applications section at the bottom of the page.
developed applications
OAuth clients you own on this account.
| app | type | created |
|---|---|---|
| reddit-reportingowned by u/northwind_ops | script | 12 Jan 2026 |
This is the old-style preferences page. The create link sits under the last app card.
Create a web app
Click are you a developer? create an app... and select the web app radio button. Type a name for the app.
Fill in the description, about url and redirect uri
Add a short description, put your product page in about url, and paste the callback URL from the PopMCP connect screen into redirect uri. Click create app.
create application
developed applications
Reddit stores one redirect uri per app and compares it character for character.
Copy the client id and secret
On the new card under developed applications, copy the client id, the short string printed under the app name and the words web app. Copy the secret field and paste both into PopMCP's Client ID and Client secret fields.
developed applications
PopMCP
- client id (under the app name)
- kQ2m****9xTbR1
- secret
- s7Vd****WcpZa0
- redirect uri
- https://app.popmcp.com/oauth/reddit/callback
- developers
- u/northwind_ops
Click edit to expand the card if the secret is not visible.
Connect in PopMCP
Open your workspace, choose Reddit in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| App typepreset | Create your app as a "web app" at reddit.com/prefs/apps (not "script"). The web-app type is what supports the browser authorization flow. |
| Client IDtext | The string shown directly under your app's name ("web app") at reddit.com/prefs/apps. |
| Client secretsecret | The "secret" field of your web app. Stored encrypted; used server-side only and never shown again.Encrypted with AES-256-GCM on save and never shown again. |
https://app.popmcp.com/api/providers/reddit/callbackAdd this exact URL to the "redirect uri" box of your "web app" at reddit.com/prefs/apps. It must match exactly, or Reddit rejects the authorization.
PopMCP verifies the credential against Reddit immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Permissions PopMCP requests
These are the scopes sent to Reddit at authorization time.
| Scope | Why PopMCP asks for it |
|---|---|
| identity | Reads the connected username so PopMCP can label the connection. Always request this. |
| edit | Edits or deletes your own posts and comments. |
| flair | Required by the tools this connector exposes. |
| history | Reads your own comment and submission history, including saved and hidden items. |
| modconfig | Changes subreddit settings. Skip it unless you need it, because it is the widest mod permission. |
| modflair | Required by the tools this connector exposes. |
| modlog | Required by the tools this connector exposes. |
| modposts | Approves, removes and distinguishes posts. Only works in subreddits you actually moderate. |
| modwiki | Required by the tools this connector exposes. |
| mysubreddits | Required by the tools this connector exposes. |
| privatemessages | Reads and sends direct messages and modmail. |
| read | Fetches listings, posts and comments. |
| report | Required by the tools this connector exposes. |
| save | Required by the tools this connector exposes. |
| submit | Creates posts and comments. |
| subscribe | Required by the tools this connector exposes. |
| vote | Required by the tools this connector exposes. |
| wikiedit | Required by the tools this connector exposes. |
| wikiread | Required by the tools this connector exposes. |
Verify it worked
PopMCP shows the Reddit connector as Connected with your u/username, and a test call returns your subscribed subreddits rather than a 403.
Troubleshooting
invalid_grant, or the consent screen never appears
Why: The app was created as a script type, which has no browser authorization flow.
Fix: Delete the app, create a new one with the web app radio button selected, then re-enter the new client id and secret.
The card shows no secret field
Why: The app was created as an installed app, and Reddit does not issue secrets to public clients.
Fix: Recreate the app as a web app.
redirect_uri mismatch on authorization
Why: Reddit stores one redirect uri per app and compares it character for character.
Fix: Click edit on the app card and paste the callback URL directly from the PopMCP connect screen, including the protocol and any trailing slash.
429 Too Many Requests
Why: The free tier caps you around 100 queries per minute per OAuth client id.
Fix: Slow the polling interval and read the x-ratelimit-remaining and x-ratelimit-reset headers. Heavier or commercial volume needs a paid agreement with Reddit.
403 on moderator endpoints
Why: The mod scopes were granted but the connected account does not moderate the target subreddit.
Fix: Connect with an account that holds the relevant moderator permission in that subreddit.
Reference
Connect Pinterest to create and schedule Pins, organise boards, track Pin and profile performance, research trends, and run your ad campaigns.
TikTok
Connect TikTok to post videos and photo carousels, send drafts to your inbox, track how each post performs, and read your profile and follower stats.