To integrate with Wix, you need to have a Wix developer account https://dev.wix.com/.

1. First of all, you need to create your own application. Select the type Build from scratch->Self-Hosted

To connect your Wix store to API2Cart, you'll need an App ID, App Secret Key, and Instance ID.

To obtain the App ID and App Secret Key, go to the Application Dashboard, then select Develop->OAuth

On this page, you should copy App ID and App Secret Key which will be needed in the next steps.

There are several ways to obtain an Instance ID, but using a webhook is the most versatile and convenient method.

To create a webhook, go to Develop->Webhooks and click Create Webhook

Select the App Installed event, add a callback URL, and click Subscribe

Please note that data will be sent to the specified callback in an encrypted format. To retrieve the webhook’s content, you need to configure your endpoint correctly. To do this, you can click Code Sample and select the pre-built code for your programming language. If your language isn’t listed, follow these instructions, which provide an example of how to work with the webhook.

You also need to select the necessary permissions. You can find a list of the required scopes in the table at the end of this guide.

2. Next, you need to install the app on the store you want to connect.

To do this, you'll need to go to the App Distribution tab and release the app

You also need to confirm that the app is compatible with both versions of the Catalogs.

You can now get a link to install the app

Next, the Wix store owner should click the link and grant permissions to the app

After installing the app, you will receive a webhook containing the Instance ID in its payload

3. Now, you can add a store to API2Cart using the App ID, App Secret Key, and Instance ID obtained in the previous steps


Table of Required Wix App Scopes for our API Methods:

Method Scopes
basket.info Manage Your App, Read Orders, Read v3 catalog (PII)
cart.catalog_price_rules.count Manage Your App, Read eCommerce - all read permissions, Read v3 catalog (PII)
cart.catalog_price_rules.list Manage Your App, Read eCommerce - all read permissions, Read v3 catalog (PII)
cart.coupon.count Manage Coupons, Manage Your App, Read v3 catalog (PII)
cart.coupon.list Manage Coupons, Manage Your App, Read v3 catalog (PII)
cart.info Manage Your App, Read Stores Locations in v3 catalog, Read v3 catalog (PII)
category.add Manage Products, Category write , Manage Your App, Read Products , Read categories , Read v3 catalog (PII)
category.assign Manage Products , Manage Your App, Read Products , Read categories , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
category.count Manage Your App, Read Products , Read categories , Read v3 catalog (PII)
category.delete Category write , Manage Products , Manage Your App, Read Products , Read categories , Read v3 catalog (PII)
category.find Manage Your App, Read Products , Read categories , Read v3 catalog (PII)
category.info Manage Your App, Read Products , Read categories , Read v3 catalog (PII)
category.list Manage Your App, Read Products , Read categories , Read v3 catalog (PII)
category.unassign Manage Products , Manage Your App, Read Products , Read categories , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
category.update Category write , Manage Products , Manage Your App, Read Products , Read categories , Read v3 catalog (PII)
customer.add Manage Contacts, Manage Your App, Read Contacts, Read v3 catalog (PII)
customer.count Manage Your App, Read Contacts, Read v3 catalog (PII)
customer.find Manage Your App, Read Contacts, Read v3 catalog (PII)
customer.info Manage Your App, Read Contacts, Read v3 catalog (PII)
customer.list Manage Your App, Read Contacts, Read v3 catalog (PII)
customer.update Manage Contacts, Manage Your App, Read Contacts, Read v3 catalog (PII)
order.abandoned.list Manage Your App, Read Contacts, Read Orders, Read v3 catalog (PII)
order.add Manage Contacts, Manage Orders, Manage Your App, Read Contacts, Read Products , Read Stores Locations in v3 catalog, Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
order.count Manage Your App, Read Orders, Read v3 catalog (PII)
order.info Manage Your App, Read Orders, Read v3 catalog (PII)
order.list Manage Your App, Read Orders, Read v3 catalog (PII)
order.shipment.add Manage Orders, Manage Your App, Read Orders, Read v3 catalog (PII)
order.shipment.delete Manage Orders, Manage Your App, Read Orders, Read v3 catalog (PII)
order.shipment.info Manage Your App, Read Orders, Read v3 catalog (PII)
order.shipment.list Manage Your App, Read Orders, Read v3 catalog (PII)
order.shipment.update Manage Orders, Manage Your App, Read Orders, Read v3 catalog (PII)
order.update Manage Orders, Manage Your App, Read Orders, Read v3 catalog (PII)
product.add Category item write , Inventory write in v3 catalog , Manage Orders , Manage Products , Manage Your App, Product write in v3 catalog , Read Stores Locations in v3 catalog , Read categories , Read v3 catalog (PII)
product.add.batch Category item write, Inventory write in v3 catalog, Manage Orders, Manage Your App, Product write in v3 catalog, Read Stores Locations in v3 catalog, Read categories, Read v3 catalog (PII)
product.brand.list Manage Your App, Read brands in catalog v3, Read v3 catalog (PII)
product.child_item.info Manage Your App, Read Products , Read inventory in v3 catalog , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
product.child_item.list Manage Your App, Read Products , Read inventory in v3 catalog , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
product.count Manage Your App, Read Products , Read categories , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
product.delete Manage Products , Manage Your App, Product write in v3 catalog , Read Products , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
product.delete.batch Manage Your App, Product write in v3 catalog, Read v3 catalog (PII)
product.find Manage Your App, Read Products , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
product.image.add Manage Products , Manage Your App, Product write in v3 catalog , Read Products , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
product.image.delete Manage Products , Manage Your App, Product write in v3 catalog , Read Products , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
product.info Manage Your App, Read Products , Read inventory in v3 catalog , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
product.list Manage Your App, Read Products , Read categories , Read inventory in v3 catalog , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
product.manufacturer.add Brand write in v3 catalog, Manage Your App, Product write in v3 catalog, Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
product.option.add Manage Products , Manage Your App, Read Products , Read v3 catalog (PII)
product.option.delete Manage Products , Manage Your App, Read Products , Read v3 catalog (PII)
product.option.value.add Manage Products , Manage Your App, Read Products , Read v3 catalog (PII)
product.option.value.delete Manage Products , Manage Your App, Read Products , Read v3 catalog (PII)
product.review.list Manage Your App, Read Products , Read reviews, Read v3 catalog (PII)
product.update Category item write , Inventory write in v3 catalog , Manage Orders , Manage Products , Manage Your App, Product write in v3 catalog , Read Products , Read Products , Read Stores Locations in v3 catalog , Read categories , Read v3 catalog (PII)
product.update.batch Category item write, Manage Orders, Manage Your App, Product write in v3 catalog OR Inventory write in v3 catalog, Read Products, Read Stores Locations in v3 catalog, Read categories, Read products in v3 catalog OR Product v3 read admin, Read v3 catalog (PII)
product.variant.update Inventory write in v3 catalog , Manage Products , Manage Your App, Product write in v3 catalog , Read Products , Read Products , Read Stores Locations in v3 catalog , Read inventory in v3 catalog , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
product.variant.update Inventory write in v3 catalog , Manage Your App, Read Products , Read Stores Locations in v3 catalog , Read products in v3 catalog OR Product v3 read admin , Read v3 catalog (PII)
subscriber.list Manage Email Subscriptions, Manage Your App, Read v3 catalog (PII)
tax.class.info Manage Orders, Manage Your App, Read v3 catalog (PII)
tax.class.list Manage Orders, Manage Your App, Read v3 catalog (PII)