Install Wix Apps on a Site

This recipe guides you through installing Wix apps on a site using the Apps Installer REST API, including enabling Velo (Wix Code) when needed.

Prerequisites

• Site ID where apps will be installed
• Knowledge of which app to install (see Apps Created by Wix)

Required APIs

• Apps Installer API: REST

Step 1: Enable Velo (Wix Code) if Needed

If you receive the error WDE0110: Wix Code not enabled, you must first enable Velo on the site.

Endpoint: POST https://www.wixapis.com/mcp-serverless/v1/velo/provision

Request:

Response: Empty body on success.

IMPORTANT NOTES:

• Only call this endpoint if you receive the WDE0110 error
• This is a one-time operation per site

Step 2: Install the Wix App

Use the Apps Installer API to install any Wix app on a site.

Endpoint: POST https://www.wixapis.com/apps-installer-service/v1/app-instance/install

Request Body:

Request:

Common App Definition IDs

Before installing, refer to the Apps Created by Wix documentation to find the correct appDefId for the app you want to install.

Some common apps:

IMPORTANT NOTES:

• I MUST NEVER guess the appDefId - always refer to the official documentation
• The tenantType MUST be SITE
• The id in tenant is the site's metaSiteId

Error Handling

App Not Installed Error

If you receive an error indicating a required app is not installed, use this recipe to install it before proceeding.

WDE0110: Wix Code not enabled

Call the Velo provision endpoint (Step 1) first, then retry the original operation.

Next Steps

After installing an app:

• Configure the app's settings using its specific APIs
• Set up any required app-specific data (products for Stores, services for Bookings, etc.)