How to set up a Wix (API v3) Sales Channel [Step-by-step guide]

Last updated: October 27, 2026

This guide covers Wix (API v3) Sales Channel setup. For instructions on Wix (API v1), see How to set up a Wix (API v1) Sales Channel [Step-by-step guide].

To connect Wix, first create the Sales Channel connection, and then set up its parameters.

Once the connection is established between the channel and techOMS, you can use its supported features as listed in: techOMS Sales Channels - Master List [Guides List].

This article is divided into the following sections:

  1. Onboarding Requirements

  2. Create the Sales Channel

  3. Configure Additional Parameters

  4. Synchronization Behavior

Make sure that you are operating under the correct Account in techOMS before starting.

I. ONBOARDING REQUIREMENTS

Before creating the Sales Channel, have the following available:

  • Wix account and site: Access to the site where you will install the techOMS app.

  • Wix Stores Catalog v3: This integration requires Wix Stores and the Catalog v3 API.

  • techOMS app installation: Install the app from the Wix App Market using the steps in Section II.

  • Warehouse identifiers: The Wix location identifiers needed to map the techOMS warehouses used for incoming orders and inventory synchronization.

Identify your Wix Catalog API version before proceeding. This integration does not support Catalog v1.

II. CREATE THE SALES CHANNEL

This section is partly performed in Wix. The following instructions are provided as guidance and may change without notice.

To create a Wix Sales Channel:

  1. Open the Wix App Market.

  2. Search for techOMS, locate the app, and click it.

  3. Click Add to Site to continue in your Wix administration console.

    If you have more than one Wix site, select the intended site and confirm again to complete the techOMS app installation.

Once confirmed, you will be automatically redirected to techOMS.

  1. Select the Sales Channel Account under which you want to create the connection.

  2. Enter a Channel Name for identification.

  3. Click Save to create the connection.

Preview

A single account can only have one Wix Sales Channel, regardless of version.

Once created, proceed to the following section.

III. CONFIGURE ADDITIONAL PARAMETERS

To configure additional parameters:

  1. Click Channels from the left menu under the Sales Channels section.

  2. Click the created channel's name.

  3. Review Sections A, B, and C, and configure the required settings.

A) QUICK ACTIONS

Quick Actions lets you perform additional actions:

  • Health Check: Checks whether the connected site uses Wix Stores Catalog v3. It reports when Catalog v1 is detected, Wix Stores is not installed, or the catalog version cannot be determined.

  • Sync: Enables manual synchronization as detailed in How to Synchronize data through a Sales Channel [Step-by-step guide]. Supported synchronization options include receiving sales orders, importing and exporting products, and sending inventory levels.

  • Save: Saves and commits changes.

  • Delete: Deletes the Sales Channel connection.

For order retrieval by ID, enter the numeric Wix Order Number in List external IDs. Wix's alphanumeric order ID is not accepted for this action. See Direct Order Retrieval and Order Hold in Section IV for its behavior.

When sending shipping updates, the tracking URL is sent together with the carrier name. The carrier name is stored in Wix but is not displayed in the Wix UI. Multiple shipments per order are supported.

If negative quantities are sent during inventory updates, Wix receives a quantity of zero instead.

B) VIEW SELECTION

View Selection allows you to navigate the different tabs:

The fields displayed in this section are dynamic. Based on your previous selections and the capabilities of the channel, certain fields may be hidden, disabled, or cascaded.

Channel Settings

  • Api Url: The base URL used for Wix REST API requests. The default is https://www.wixapis.com.

  • Instance Id: The identifier generated by Wix for the techOMS app installation on your site.

  • Site Id: The identifier of the Wix site associated with the connection. This alphanumeric identifier contains dashes and can be found in the address bar while managing the site in Wix.

  • Download Orders with the following Order Status: Select the Wix order statuses eligible for normal order synchronization: Initialized, Pending, Approved, Canceled, or Rejected. The default selection is Approved. Direct retrieval by Wix Order Number bypasses this status filter.

  • Throughput: Keep Default, the available setting used to control the channel's request rate.

  • Process Pickups?: Controls whether pickup orders are synchronized into techOMS. Select No to exclude pickup orders, or Yes to synchronize them along with delivery orders. The default is No.

Mappings

When pulling orders, techOMS uses the location assigned to the order. If no location is assigned, it retrieves the site's default business location in Wix. The order is not synchronized if no default location is configured when one is needed, or if the assigned or default location has no matching Warehouse Mapping. These requirements also apply to direct order retrieval.

Inventory synchronization requires a mapped Wix stock location. Inventory from unmapped techOMS warehouses is excluded. A mapped location that is not a stock location cannot receive the inventory update.

Webhooks

Use the following procedure to configure Wix Automations to send order webhooks to techOMS.

This procedure requires Mode to be set to Webhook in Main Settings. For more information, see How to configure Automations for Sales/Fulfillment channels [Step-by-step guide].

i. Pre Setup Steps in techOMS
  1. Open the Sales Channel, select the Webhooks tab, and click Create.

  2. Select the connection type from Type. The system automatically generates a URL. For Wix, the available type is ecommerce/order/created.

  3. Copy the generated URL, do not save, and click Cancel.

You need this URL to configure the automation in Wix. The automation is created in Wix, rather than saved as a webhook registration in techOMS.

ii. Wix Setup Steps

Log in to your Wix site.

  1. Select Automations from the left menu.

  2. Select Create Automation.

  3. In the pop-up screen, select Start from Scratch.

  4. In the left menu, select the Order placed trigger.

  5. Click the + icon under Order placed to add an action.

  6. Select Send HTTP Request.

  7. In Send HTTP Request, keep Method set to POST, paste the Webhook URL copied in Pre Setup step 3, and keep Body params set to Entire payload, as shown in the reference screenshot.

  8. Click Activate in the top-right corner.

Once the automation is activated, Wix sends order events automatically; no manual approval is required. In techOMS, the configured order status filter, Warehouse Mappings, and Process Pickups? setting still determine whether the order is imported.

C) CONTENT VIEW

Content View displays and/or allows editing of the settings selected in View Selection.

Click Save to commit the changes made in this section.

Inventory can be viewed and filtered by location in the Wix v3 Inventory view.

IV. SYNCHRONIZATION BEHAVIOR

Sales Orders and Shipments

Normal order retrieval uses the selected date range and Download Orders with the following Order Status filter. Webhook-based retrieval also applies the configured order status filter.

Shipment updates send shipment information to existing Wix orders, including carrier, tracking number, and tracking URL when available. Multiple shipments per order are supported. The techOMS Sales Order must be in Fulfilling or Shipped status for shipment updates to be sent.

Direct Order Retrieval and Order Hold

The Receive Sales Orders From Channel By ID workflow retrieves specific orders using their numeric Wix Order Numbers.

  • Order identifier: Use the Wix Order Number assigned when the order was created. The same value becomes the techOMS Order Number during import. The separate Wix alphanumeric order ID is stored in the ExternalOrderID reference; do not enter that value for direct retrieval.

  • Manual retrieval: In Sync, open Receive Sales Orders From Channel, turn off Use Date Range, and enter the Wix Order Number in List external IDs.

  • Status filters: Direct retrieval does not apply the normal download status filter or date range. It can therefore retrieve an available order whose current status would exclude it from normal synchronization.

  • Other import requirements: Warehouse Mappings and Process Pickups? still apply. Bypassing the status filter does not bypass these requirements.

  • Order Hold: When Order Hold is enabled for your account and the workflow requests an order before releasing it, this retrieval allows techOMS to receive the latest supported Wix order data before downstream processing continues. Hold configuration belongs to the shared techOMS workflow; no additional Wix-specific Hold setting is introduced.

  • Order not returned: If the number does not match an available Wix order, no matching order is returned. Confirm the Wix Order Number, the connected site, the order's availability, its Warehouse Mapping, and the pickup setting where applicable.

Products and Inventory

The channel supports product import, product export, inventory levels, and inventory level adjustments.

Inventory is sent by SKU and mapped stock location. A product variant with the matching SKU must exist in Wix. Inventory adjustment synchronization sends the total available quantity for the mapped warehouse, rather than adding or subtracting the adjustment amount from Wix inventory.

Wix Product Export Behavior

Wix handles product data differently from techOMS. Consider the following behaviors when exporting or updating products.

When creating or updating products with multiple variants, provide at least one variant option: Color or Size. Products with multiple variants and no supported variant options cannot be processed correctly by Wix.

  • Product combination behavior: If only specific variant combinations exist in techOMS, such as White-Small and Black-Medium, the export also supplies the remaining combinations, such as White-Medium and Black-Small.

Combinations not defined in techOMS are created in Wix with zero price and hidden from the storefront. Only variants explicitly created in techOMS should be enabled for sale.

  • Product description formatting: Wix product descriptions use structured formatting. When updating existing products, techOMS leaves the description unchanged to preserve its content and layout. When creating new products, descriptions are applied as plain paragraphs.

Automation

The channel supports Recurring Jobs and Webhooks. Configure the general automation behavior in Main Settings and use the Webhooks procedure in Section III when configuring Wix order events.