---
updatedAt: 2025-09-25T09:49:09.000Z
agentTools:
  projectIndex: https://developers.intandem.tech/llms.txt
---

# App Installed

Notifying when a business  installs an app (either for the first time or after uninstalling it)

The event is triggered when a business installs an app

there is a distinguish between app install webhooks for an app and for directory/business

## Directory/Business

**Webhook authorization:** using a business or a directory token.

### Subscribing to the App Installed webhook:

```curl
curl --location --request POST '/platform/v1/webhook/subscribe' \
--header 'Authorization: "Bearer Directory/business API_TOKEN"'\
--header 'Content-Type: application/json' \
--data-raw '{
"event": "app_subscription/installed",
"target_url": "URL"
}'

```

### App Installed Payload Example:

```json
{
  "entity_name": "app_subscription",
  "event_type": "installed",
  "data": {
    "business_id": "3fd234234d4",
    "app_id": "app unique name"
  }
}
```

## App

**Webhook authorization:** using an app token.

### Subscribing to the App Installed webhook

```curl
curl --location --request POST '/platform/v1/webhook/subscribe' \
--header 'Authorization: "Bearer App API_TOKEN"'\
--header 'Content-Type: application/json' \
--data-raw '{
"event": "application/installed",
"target_url": "URL"
}'

```

### App Installed Payload Example:

```json
{
  "entity_name": "application",
  "event_type": "installed",
  "data": {
    "business_id": "ato23v21hj30krxm",
    "app_code_name": "myapp",
    "event_time": "2024-03-17T23:11:10.394-06:00"
  }
}
```