Reddit · OAuth Scopes

Reddit OAuth Scopes

OAuth 2.0 derived

Reddit publishes 20 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Reddit API on a user’s behalf.

Tokens are issued from https://www.reddit.com/api/v1/access_token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

AdvertisingCommunitiesContentSocial MediaSocial News

Scopes: 20 Flows: authorizationCode Method: derived

OAuth endpoints

Authorization URL
https://www.reddit.com/api/v1/authorize

Token URL
https://www.reddit.com/api/v1/access_token

Flows
authorizationCode

Scopes (20)

Scope	Description	Flows
ads	Access to ads management endpoints	authorizationCode
edit	Edit and delete content	authorizationCode
flair	Set user and link flair	authorizationCode
history	Access voting history	authorizationCode
identity	Access user identity	authorizationCode
modconfig	Manage subreddit configuration	authorizationCode
modflair	Manage subreddit flair	authorizationCode
modlog	Access moderation log	authorizationCode
modposts	Approve and remove content	authorizationCode
modwiki	Manage wiki pages	authorizationCode
mysubreddits	Access subscribed subreddits	authorizationCode
privatemessages	Access private messages	authorizationCode
read	Read content	authorizationCode
report	Report content	authorizationCode
save	Save and unsave content	authorizationCode
submit	Submit content	authorizationCode
subscribe	Manage subscriptions	authorizationCode
vote	Vote on content	authorizationCode
wikiedit	Edit wiki pages	authorizationCode
wikiread	Read wiki pages	authorizationCode

📄 Provider scope reference:

Source

OAuth Scopes

generated: '2026-07-11'
method: derived
source: openapi/reddit-ads-api-openapi.yml, openapi/reddit-data-api-openapi.yml
schemes:
- name: oauth2
  source: openapi/reddit-ads-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://www.reddit.com/api/v1/authorize
    tokenUrl: https://www.reddit.com/api/v1/access_token
  description: Reddit Ads API uses OAuth 2.0 for authentication. Access tokens are obtained
    via the authorization code flow.
- name: oauth2
  source: openapi/reddit-data-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://www.reddit.com/api/v1/authorize
    tokenUrl: https://www.reddit.com/api/v1/access_token
  description: Reddit uses OAuth 2.0 for authentication. All API requests must include a valid
    access token obtained through one of the supported OAuth grant types.
scopes:
- scope: ads
  description: Access to ads management endpoints
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-ads-api-openapi.yml
- scope: edit
  description: Edit and delete content
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: flair
  description: Set user and link flair
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: history
  description: Access voting history
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: identity
  description: Access user identity
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: modconfig
  description: Manage subreddit configuration
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: modflair
  description: Manage subreddit flair
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: modlog
  description: Access moderation log
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: modposts
  description: Approve and remove content
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: modwiki
  description: Manage wiki pages
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: mysubreddits
  description: Access subscribed subreddits
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: privatemessages
  description: Access private messages
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: read
  description: Read content
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: report
  description: Report content
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: save
  description: Save and unsave content
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: submit
  description: Submit content
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: subscribe
  description: Manage subscriptions
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: vote
  description: Vote on content
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: wikiedit
  description: Edit wiki pages
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml
- scope: wikiread
  description: Read wiki pages
  flows:
  - authorizationCode
  sources:
  - openapi/reddit-data-api-openapi.yml