scope_granted event

Developer preview has ended

This feature was exclusive to our workspace apps developer preview. The preview has now ended, but fan-favorite features such as token rotation and the Conversations API will become available to classic Slack apps over the coming months.

OAuth scopes were granted to your app

Compatibility: Events API

When subscribed and your workspace app is granted a new scope, we'll dispatch this event to tell you about it.

    "token": "verification-token",
    "team_id": "T1DD3JH3K",
    "api_app_id": "A7449NRUL",
    "event": {
        "type": "scope_granted",
        "scopes": [
        "trigger_id": "241582872337.47445629121.string"
    "type": "event_callback",
    "authed_teams": [],
    "event_id": "Ev74V2J98E",
    "event_time": 1505519097

The inner event describes an array of awarded scopes and includes a trigger_id you may use with or Permissions API requests.

Events API compatibility

Subscribe to this event via the Events API.

Events of this type will be wrapped in metadata when sent via the Events API.

Unavailable in the RTM API

This event type is compatible only with the Events API.

Was this page helpful?