Event type


OAuth scopes were granted to your app


Works with

Events API
Workspace apps are deprecated

Legacy workspace apps are deprecated and will retire in August 2021. Learn more.


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 dialog.open or Permissions API requests.