X (Twitter) · OAuth Scopes

X (Twitter) OAuth Scopes

OAuth 2.0 derived

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

Tokens are issued from https://api.x.com/2/oauth2/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.

Social MediaMicrobloggingReal-Time DataStreamingAdvertisingContent

Scopes: 21 Flows: authorizationCode Method: derived

OAuth endpoints

Authorization URL
https://api.x.com/2/oauth2/authorize

Token URL
https://api.x.com/2/oauth2/token

Flows
authorizationCode

Scopes (21)

Scope	Description	Flows
block.read	View accounts you have blocked.	authorizationCode
bookmark.read	Read your bookmarked Posts.	authorizationCode
bookmark.write	Create and delete your bookmarks.	authorizationCode
dm.read	Read all your Direct Messages.	authorizationCode
dm.write	Send and manage your Direct Messages.	authorizationCode
follows.read	View accounts you follow and accounts following you.	authorizationCode
follows.write	Follow and unfollow accounts on your behalf.	authorizationCode
like.read	View Posts you have liked and likes you can see.	authorizationCode
like.write	Like and unlike Posts on your behalf.	authorizationCode
list.read	View Lists, members, and followers of Lists you created or are a member of, including private Lists.	authorizationCode
list.write	Create and manage Lists on your behalf.	authorizationCode
media.write	Upload media, such as photos and videos, on your behalf.	authorizationCode
mute.read	View accounts you have muted.	authorizationCode
mute.write	Mute and unmute accounts on your behalf.	authorizationCode
offline.access	Request a refresh token for the app.	authorizationCode
space.read	View all Spaces you have access to.	authorizationCode
timeline.read	View all Custom Timelines you can see, including public Custom Timelines from other developers.	authorizationCode
tweet.moderate.write	Hide and unhide replies to your Posts.	authorizationCode
tweet.read	View all Posts you can see, including those from protected accounts.	authorizationCode
tweet.write	Post and repost on your behalf.	authorizationCode
users.read	View any account you can see, including protected accounts.	authorizationCode

📄 Provider scope reference:

Source

OAuth Scopes

generated: '2026-07-11'
method: derived
source: openapi/x-api-openapi.json
schemes:
- name: OAuth2UserToken
  source: openapi/x-api-openapi.json
  flows:
  - flow: authorizationCode
    authorizationUrl: https://api.x.com/2/oauth2/authorize
    tokenUrl: https://api.x.com/2/oauth2/token
scopes:
- scope: block.read
  description: View accounts you have blocked.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: bookmark.read
  description: Read your bookmarked Posts.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: bookmark.write
  description: Create and delete your bookmarks.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: dm.read
  description: Read all your Direct Messages.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: dm.write
  description: Send and manage your Direct Messages.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: follows.read
  description: View accounts you follow and accounts following you.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: follows.write
  description: Follow and unfollow accounts on your behalf.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: like.read
  description: View Posts you have liked and likes you can see.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: like.write
  description: Like and unlike Posts on your behalf.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: list.read
  description: View Lists, members, and followers of Lists you created or are a member of, including
    private Lists.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: list.write
  description: Create and manage Lists on your behalf.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: media.write
  description: Upload media, such as photos and videos, on your behalf.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: mute.read
  description: View accounts you have muted.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: mute.write
  description: Mute and unmute accounts on your behalf.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: offline.access
  description: Request a refresh token for the app.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: space.read
  description: View all Spaces you have access to.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: timeline.read
  description: View all Custom Timelines you can see, including public Custom Timelines from
    other developers.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: tweet.moderate.write
  description: Hide and unhide replies to your Posts.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: tweet.read
  description: View all Posts you can see, including those from protected accounts.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: tweet.write
  description: Post and repost on your behalf.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json
- scope: users.read
  description: View any account you can see, including protected accounts.
  flows:
  - authorizationCode
  sources:
  - openapi/x-api-openapi.json