New Webhook: App Installed

Starting September 10th, 2024, (shareable) apps receive a webhook when the app is installed on any Benchling tenant.

The webhook is triggered when clicking the “Install” or “Upgrade” button on the app’s install page:

Install page with "Install" button Install page with "Upgrade" button

The app version is included in the payload, letting you determine if a tenant is installing the app for the first time or upgrading from an earlier version of the app.

The full payload for the v2.app.installed webhook:

{  
    "version": "0",  
    "baseURL": "<https://staging.bnchdev.org">,  
    "tenantId": "ten_qka2rgzb1k",  
    "app": {  
        "id": "app_M4YccSZUlgtmwv4P"  
    },  
    "appDefinition": {  
        "id": "appdef_XsmKVPMYtc",  
        "versionNumber": "0.1.1"  
    },  
    "channel": "app_signals",  
    "message": {  
        "type": "v2.app.installed",  
        "deprecated": false  
    }  
}

Any app with a valid webhook URL will automatically subscribe to this webhook.