> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Add Apps with the REST API

## Article: Add Apps with the REST API

## Article Link: https://dev.wix.com/docs/go-headless/project-management/add-apps-with-the-rest-api.md

## Article Content:

# Add Apps with the REST API

Call the [Install App](https://dev.wix.com/docs/api-reference/business-management/app-installation/app-installation/install-app.md) method to add apps to your headless project from code. This is especially useful for AI agents that set up projects, and for scripting project setup, provisioning multiple projects, or building your own automation.

To add apps from the dashboard, see [Add Apps to a Project](https://dev.wix.com/docs/go-headless/project-management/add-apps-to-a-project.md).

> **Important:** Only [Wix users](https://dev.wix.com/docs/api-reference/articles/authentication/about-identities.md) and [API key admins](https://dev.wix.com/docs/api-reference/articles/authentication/about-identities.md) can call the App Installation API. Unlike most [admin API calls](https://dev.wix.com/docs/go-headless/authentication/admin/about-admin-operations.md), it doesn't accept access tokens generated with client credentials. To call it from your own code, use an API key.

## Before you begin

To call the method, you need:

- **An API key** with account-level permissions. Learn how to [generate an API key](https://dev.wix.com/docs/go-headless/authentication/admin/generate-an-api-key.md).
- **Your project's site ID**. Learn how to [retrieve a site ID](https://dev.wix.com/docs/go-headless/authentication/admin/generate-an-api-key.md#retrieve-a-site-id-or-account-id).
- **The ID of the app to install**. Every [app created by Wix](https://dev.wix.com/docs/api-reference/articles/work-with-wix-apis/platform/about-apps-created-by-wix.md) has a fixed ID.

## Install an app

Call [Install App](https://dev.wix.com/docs/api-reference/business-management/app-installation/app-installation/install-app.md) with your project's site ID as the tenant and the ID of the app to install:

```bash
curl -X POST 'https://www.wixapis.com/apps-installer-service/v1/app-instance/install' \
  -H 'Authorization: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "tenant": {
      "tenantType": "SITE",
      "id": "<SITE_ID>"
    },
    "appInstance": {
      "appDefId": "<APP_ID>"
    }
  }'
```

The response confirms the installation and includes the ID of the new app instance:

```json
{
  "appInstance": {
    "id": "51048018-0b40-40b5-a8ee-26875b7ceb14",
    "appDefId": "14bcded7-0066-7c35-14d7-466cb3f09103",
    "enabled": true
  },
  "dependenciesInstallation": []
}
```

If the app depends on other apps, Wix installs them as well and lists them in `dependenciesInstallation`.

Once you install an app, its APIs are available on your project. To remove an app, call [Uninstall App](https://dev.wix.com/docs/api-reference/business-management/app-installation/app-installation/uninstall-app.md) with the same tenant and app ID.

## Verify the installation

To list the apps on your project, call [Get Installed Apps](https://dev.wix.com/docs/api-reference/business-management/app-installation/app-installation/get-installed-apps.md):

```bash
curl 'https://www.wixapis.com/apps-installer-service/v1/app-instances' \
  -H 'Authorization: <API_KEY>' \
  -H 'wix-site-id: <SITE_ID>'
```

The response lists an app instance for each installed app. You can also see your installed apps in the project dashboard under **Apps** > **Manage Apps**.

## See also

- [About the App Installation API](https://dev.wix.com/docs/api-reference/business-management/app-installation/app-installation/introduction.md)
- [About Admin Operations](https://dev.wix.com/docs/go-headless/authentication/admin/about-admin-operations.md)
- [Add Apps to a Project](https://dev.wix.com/docs/go-headless/project-management/add-apps-to-a-project.md)