> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Wix - How do I link my account?

## Overview

To authenticate with Wix, you need:

1. **App ID** - The ID of your self-managed Wix app.
2. **App secret** - The secret of that app.
3. **App instance ID** - The `instanceId` of your app's installation on the Wix site to connect.

Each app instance belongs to one site. To connect several sites, create one connection for each.

## Prerequisites

* A Wix Studio account. If you don't have one, [sign up](https://manage.wix.com/account/custom-apps).
* Your app installed on the Wix site you want to connect.

## Instructions

### Step 1: Create a Wix app

1. Log in to Wix Studio and open [Custom Apps](https://manage.wix.com/account/custom-apps).
2. Click **Create New App**, then under **Self-managed** choose **Start From Scratch** and click **Create App**. To use an existing app, open it from the list instead.

![Wix Studio Custom Apps page with the Create New App button](https://mintcdn.com/nango/9b42Lr5DKhJH32AY/api-integrations/wix/custom_apps_create.png?fit=max\&auto=format\&n=9b42Lr5DKhJH32AY\&q=85\&s=2737ebdaf2f2f1fdac73c0bddf6cc486)

3. On your app's **Permissions** page, add the permissions your API calls need. For example, getting the app instance needs **Manage Your App**.

### Step 2: Copy your app ID and app secret

1. In your app's dashboard, go to **Develop** -> **OAuth**.
2. Copy the **App ID** with the copy button next to it.
3. Click the eye icon next to **App secret** to reveal it, then copy it. Keep the secret confidential.

![App keys on the OAuth page of a Wix app, with the App ID copy button and the App secret eye icon](https://mintcdn.com/nango/9b42Lr5DKhJH32AY/api-integrations/wix/oauth_app_keys.png?fit=max\&auto=format\&n=9b42Lr5DKhJH32AY\&q=85\&s=447f167f5e67dc5d5ce728a5fee67845)

![App ID and App secret fields on the OAuth page of a Wix app, with the secret revealed](https://mintcdn.com/nango/9b42Lr5DKhJH32AY/api-integrations/wix/wix_oauth_app_keys.png?fit=max\&auto=format\&n=9b42Lr5DKhJH32AY\&q=85\&s=557426a353083f5735d4e744b389b4c6)

### Step 3: Get the app instance ID

The app instance ID identifies your app's installation on one site. Install the app on the site (to test on a development site, click **Test App** -> **Test on dev site**), then get its `instanceId` from one of these:

* The [App Instance Installed](https://dev.wix.com/docs/rest/app-management/app-instance/app-instance-installed) event, sent when your app is installed on a site. Wix suggests subscribing to it to save the `instanceId`. If your app subscribes to it, go to **Develop** -> **Webhooks** -> **Logs**: the **App Installed** row shows the **Instance ID**.
* The payloads of other events Wix sends your app.
* The app instance query parameter that Wix passes to your app's iframes and external pages.

![Webhook logs of a Wix app, with the Instance ID column of the App Installed event](https://mintcdn.com/nango/9b42Lr5DKhJH32AY/api-integrations/wix/wix_instance_id_webhook_log.png?fit=max\&auto=format\&n=9b42Lr5DKhJH32AY\&q=85\&s=87517a846a871e99dcc4ca97c55fc021)

See [About app instances](https://dev.wix.com/docs/build-apps/develop-your-app/auth/app-instances/about-app-instances) for details.

### Step 4: Enter your credentials in the Connect UI

1. Open the form where you need to authenticate with Wix.
2. Enter your **App ID**, **App secret**, and **App instance ID**.
3. Click **Connect**. Nango requests an access token from Wix with these values, so wrong credentials are rejected.

![Nango Connect UI form for entering a Wix app ID, app secret, and app instance ID](https://mintcdn.com/nango/9b42Lr5DKhJH32AY/api-integrations/wix/form.png?fit=max\&auto=format\&n=9b42Lr5DKhJH32AY\&q=85\&s=a9a8fd4c9707e2140fa100b760715d60)

You are now connected to Wix.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.