WIX: OAuth Connection Using Client Credentials Flow

Connecting Wix with Pabbly Connect (New Authentication Flow)​

This guide explains how to connect your Wix account with Pabbly Connect using Wix’s new App Instance–based authentication flow.
It also covers permissions, webhooks, and instance ID extraction, which are mandatory as per Wix’s latest requirements.

---

Prerequisites​

Before you begin, make sure you have:

• A Wix account
• An App created in Wix Developer Center
• Access to Pabbly Connect

---

Overall Flow (High Level)​

1. Create a workflow in Pabbly Connect
2. Capture App Installed webhook from Wix
3. Extract Instance ID from webhook (JWT)
4. Use App ID + App Secret + Instance ID to connect Wix

---

Step 1: Create a Workflow in Pabbly Connect​

1. Log in to Pabbly Connect
2. Click Create Workflow
3. Select Webhook by Pabbly as the trigger
4. Copy the Webhook URL
5. Click on Capture Webhook Response.

You will use this URL in Wix to capture the App Installed event.

---

Step 2: Create “App Installed” Webhook in Wix​

1. Open Wix Custom Apps dashboard
   https://manage.wix.com/studio/custom-apps
2. Search for your app.
3. Click the three dots (⋯) next to your app
4. Select Go to App Dashboard
   
5. Navigate to:
   Develop → Webhooks
6. Click Create Webhook
   
7. Configure the webhook:
   • Category: App Instance
   • Event: App Installed
   • Callback URL: Paste the Pabbly Webhook URL (from Step 1)
   • Save: Click Subscribe
     

---

Step 3: Install the App on Your Wix Site​

1. From the app dashboard, click Distribute App dropdown
2. Click Install on a Site
   
3. Select your site where you want to install the app

As soon as the app is installed, Wix will fire the App Installed webhook.

---

Step 4: Capture Webhook Response in Pabbly​

• Go back to your Pabbly workflow
• The webhook trigger will receive a response automatically
  

Important Note
The webhook response is in JWT (encoded) format and is not a JSON format.
You must extract the Instance ID from it.

---

Step 5: Extract Instance ID (Mandatory Step)​

1. Add a new action step in Pabbly
2. Choose:
   • App: Data Transformer (Pabbly)
   • Action Event: Wix Instance ID Extractor
   • Click connect
3. Provide:
   • The JWT token received from the webhook
4. Click Save & Send Test Request
   

• You will now see the Instance ID in the response.
• Copy and save this Instance ID — you will need it to create the Wix connection.

---

Step 6: Add Required Permissions in Wix (Very Important)​

If you try to perform actions like Get Contact, Create Contact, etc. without permissions, Wix will return a 403 Forbidden error.

How to Add Permissions​

1. Go to your Wix App Dashboard
   
2. Navigate to:
   Develop → Permissions
3. Click + Add Permissions
   
4. Add the permissions required for your use case
   Example:
   • Contacts & Members → Read / Create / Update Contacts
   • Wix Stores → Manage Products
   • Any other scope your actions need
5. Click Save

---

Step 7: Release a New Version of the App​

After adding permissions:

1. Go to your Wix App Dashboard
2. Click Release New Version
   
   

Permissions only take effect after releasing a new version.

---

Step 8: Reinstall the App (Mandatory After Permission Change)​

If your app was already installed on a site:

1. Go to Wix Site Dashboard, https://manage.wix.com/studio/sites?referralInfo=sidebar&viewId=all-items-view
2. Navigate to:
   
   Sites → [click on your site] → Apps → Manage Apps
   
   
3. Uninstall / Remove your app
   
4. Reinstall the app again (Refer to Step 3)

Why this is required:​

Wix grants permissions only at install time.
Reinstallation allows the app to grasp the newly added permissions.

When you reinstall:

• The App Installed webhook fires again
• Pabbly captures a new JWT

➡ Repeat Step 5 to extract and save the new Instance ID.

---

Step 9: Connect Wix in Pabbly Connect​

1. Add a new action step in your workflow
2. Choose:
   • App: Wix
   • Action Event: (Example: Get Contact by Email)
3. Click Connect
4. Select Add New Connection
5. Enter:
   • App ID
   • App Secret Key
   • Instance ID (from Step 5)
6. Click Save

Your Wix connection is now established successfully.

Start Using Wix Actions!​

---

​