apps.event.authorizations.list
method
We're still building and not all features are available quite yet. Enjoy this peek into the future!
Not ready for the future? Return to the past at api.slack.com.
Usage info
This method returns a list of authorizations for the given event specified by event_context
. Each authorization represents an app installation that the event is visible to.
How do I find an event_context
to call this method with?
You'll receive an event_context
identifying an event in each event payload sent to your app.
What do authorizations signify?
Authorizations are installations of your app. If your app has been installed multiple times, you'll probably have multiple authorizations for some events.
When should I call this method?
Call this method to see all the installations of your app than an event is visible to. Sometimes, only certain installations have permission to know about an event.
How do I get permission to call this method
Calling this method is just like any other Web API method. However, since this method lists multiple installations of your app, you'll need an app-level token.
You'll obtain the app-level token by going to your app settings and scrolling down to the App-Level Tokens section on the Basic Information page. CLick Generate Token and Scopes
to get the token. You'll also request the authorizations:read
scope.
For this method, you will need to pass this token in the HTTP Authorization
header of your request; passing it as a POST parameter will result in an error.