app_installed event

User has installed an app

Facts

Required Scopes

No scopes required!

Compatible APIs

Events

Usage info

This example includes both the event wrapper and the event structure for the app_installed event.

{
    "token": "XXYYZZ",
    "team_id": "T123ABC456",
    "api_app_id": "A123ABC456",
    "event": {
        "type": "app_installed",
        "app_id": "A015CA1LGHG",
        "app_name": "my-admin-app",
        "app_owner_id": "U013B64J7MSZ",
        "user_id": "U013B64J7SZ",
        "team_id": "E073D7H7BBE",
        "team_domain": "ACME Enterprises",
        "event_ts": "1700001891.279278"
    },
    "type": "event_callback",
    "authorizations": [
        {
            "team_id": "T123ABC456",
            "user_id": "U123ABC456",
            "is_bot": false,
            "is_enterprise_install": false,
        }
    ],
    "event_id": "Ev123ABC456",
    "event_time": 123456789
}

The app_installed event payload contains information about an app that has been installed on a team or organization.

Only organization-wide apps can subscribe to this event.

Field	Description
app_id	The app that was installed on the team.
app_name	The name of the app the was installed on the team.
app_owner_id	The owner of the app that was installed on the team.
user_id	The user that installed the app on the team.
team_id	The team that the app was installed on.
team_domain	The domain of the team that the app was installed on.
event_ts	Time the app was installed.