app_requested event
User requested an app
Compatibility:Â Events API
Expected scopes:
{
"type": "app_requested",
"app_request":{
"id": "1234",
"app": {
"id": "A5678",
"name": "Brent's app",
"description": "They're good apps, Bront.",
"help_url": "brontsapp.com",
"privacy_policy_url": "brontsapp.com",
"app_homepage_url": "brontsapp.com",
"app_directory_url": "https://slack.slack.com/apps/A102ARD7Y",
"is_app_directory_approved": true,
"is_internal": false,
"additional_info": "none"
},
"previous_resolution": {
"status": "approved",
"scopes": [
{
"name": "app_requested",
"description": "allows this app to listen for app install requests",
"is_sensitive": false,
"token_type": "user",
}]
},
"user":{
"id": "U1234",
"name": "Bront",
"email": "bront@brent.com"
},
"team": {
"id": "T1234",
"name": "Brant App Team",
"domain": "brantappteam"
},
"scopes": [
{
"name": "app_requested",
"description": "allows this app to listen for app install requests",
"is_sensitive": false,
"token_type": "user"
}
],
"message": "none"
}
}
The app_requested
event payload contains info about an app that a user on a team has requested to install.
- The
app
field gives info on the app that the user has requested. Nested inside theapp
field, thehelp_url
,privacy_policy_url
,app_homepage_url
, andapp_directory_url
fields contain links to more information on the app. - The
previous_resolution
field indicates whether the app was previously approved or restricted in this org. If the app installation has not been requested before,previous_resolution
won't appear in the payload. - The
user
field gives info on the user requesting the install. - The
team
field gives info on the team that the app will be installed on. - The
scopes
field gives info on the scopes that the app requests. - The
message
field may contain an optional message from the app.
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.