OAuth Permission Scopes

Last edited: Sep 18, 2020

Permission (OAuth) scopes are the permissions that AnonymityBot requires to function properly in Slack. You might find it useful to view Slack's guidance about understanding these permissions scopes.


Add the /anon command and the Post Anonymously, Poll Anonymously and Open Menu shortcuts.


Post anonymous messages, polls, replies and help messages.


Automatically join public channels where you use AnonymityBot, without you needing to manually /invite @AnonymityBot.


Respond to direct mentions of the AnonymityBot app, to display help text about how to use the app.


Keep AnonymityBot up to date when a workspace domain or name changes, which helps prevent some bugs. Also used to display the workspace icon in the AnonymityBot dashboard.

channels:read, groups:read, usergroups:read

Keep an up-to-date state of channels, groups (invited only) and usergroups for our channel whitelisting feature (and soon usergroup whitlisting feature).


Deliver notifications to individual users. For instance, in the case of a problem with the creation of an anonymous message or poll.


View messages and mentions of AnonymityBot in user's direct message channel with AnonymityBot.

users:read, users:read.email

Count the number of users in a workspace (for our pricing model) and save a per user state (e.g. indication if an onboarding message has already been sent). We use email addresses to respond to feedback, to contact users and admins regarding the product and billing.