Event on Application Uninstallation: onAppUninstall

Scope: basic

Who can subscribe: any user

The onAppUninstall event is triggered when an application is uninstalled.

Events will not be sent to the application until the installation is complete. Check the application installation

What the Handler Receives

Data is transmitted as a POST request

{
            "event": "ONAPPUNINSTALL",
            "data": {
                "LANGUAGE_ID": "de",
                "CLEAN": 1
            },
            "ts": "1466439714",
            "auth": {
                "domain": "some-domain.bitrix24.com",
                "server_endpoint": "https://oauth.bitrix.info/rest/",
                "client_endpoint": "https://some-domain.bitrix24.com/rest/",
                "member_id": "a223c6b3710f85df22e9377d6c4f7553",
                "application_token": "51856fefc120afa4b628cc82d3935cce"
            }
        }

Request Parameters

Required parameters are marked with *

Name
type

Description

event*
string

Symbolic event code — ONAPPUNINSTALL

data*
object

Data about the uninstalled application.

The structure is described below

ts*
timestamp

Date and time the event was sent from the queue

auth*
object

Authorization and account data.

The structure is described below

Parameter data

Required parameters are marked with *

Name
type

Description

LANGUAGE_ID*
string

Installed language: de, en, and others

CLEAN*
integer

Value of the "Clear application data" option set by the user during uninstallation. Values: 1 or 0

Parameter auth

Required parameters are marked with *

Name
type

Description

domain*
string

Bitrix24 account address

server_endpoint*
string

Authorization server address for token refresh

client_endpoint*
string

Common path for API method calls

member_id*
string

Unique account identifier

application_token*
string

Token for secure event handling

When an application is uninstalled, all access permissions for the application to the API are revoked. Therefore, even though the event handler will receive authorization data, it can no longer use the API on behalf of the uninstalled application.

Continue Learning

Previous
After Application Update
Next
When Paying for the Application