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 0: Find the App ID (skip if you already have it)

If you already know the appDefId (e.g. from the table of Wix-built apps below), skip to Step 1.

For any third-party app, or any app you only know by name, resolve the ID first using the Search Market Listings API.

Endpoint: POST https://www.wixapis.com/devcenter/app-market-listing/v1/market-listings/search

Request:

Response (truncated):

Use the returned appId as the appDefId in Step 2.

IMPORTANT NOTES

• The appDefId field in the install request and the appId field returned here are the same value
• If multiple results come back, match on basicInfo.name to confirm you have the right app before installing
• Only listings with status: "PUBLISHED" can be installed

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:

• NEVER guess the appDefId. For Wix-built apps, use the table above. For any other app, resolve the ID using Step 0 (Search Market Listings).
• 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.)

Common Pitfalls

• "I don't have the appDefId" → Run Step 0. The table in Step 2 only covers Wix-built apps; the App Market has thousands of others.
• Don't try to scrape the App Market website to find IDs — pages are client-rendered and the appId is not in the HTML. Use Search Market Listings instead.
• Don't try InstallAppFromShareUrl as a workaround for unknown IDs — shareUrlId is an internal identifier you generally don't have either.