Permissions

What each scope allows. People see these before they allow; ask only for what your app uses.

ScopeWhat it allows
openidSign in. Stable account ID. Always included.
profilePublic profile. Username, display name, avatar, join date.
offline_accessStay signed in. Refresh tokens, so people don't sign in again until they remove the app.
content:readPosts and profiles. Feed, posts, comments, profiles and follower lists as the user sees them, including private accounts they follow.
search:readSearch. People, posts, hashtags and topics.
library:readSaved posts and likes. The posts the user saved and liked.
notifications:readNotifications. Likes, replies, mentions and follows; mark as read. Never DMs or security notices.
settings:readSettings. Privacy, notification, feed and translation settings. Never password, two-factor or sessions.
posts:writePublish posts. Text, photos, audio, GIFs, long posts and scheduling. Rate limited.
posts:interactLike, repost, comment. In the user's name. Rate limited.
library:writeSave posts. Add and remove saved posts.
follows:writeFollow. Follow and unfollow; approve or decline follow requests.
profile:writeEdit profile. Display name, bio, links, profile photo and banner. Not username, password or security.
posts:manageEdit and delete posts and comments. Including ones made outside your app.
safety:manageBlock, mute, report. See and change blocked and muted accounts; send reports. Blocking removes follows.
settings:writeChange settings. Private account, who can message or mention, notifications, feed and translation. Not username, password or two-factor.