Skip to Content

Wix

Connect a Wix site to manage its Stores product catalog and react to new orders. metamorphOS reads and edits your products, looks up eCommerce order details, and Wix notifies metamorphOS whenever a customer places an order.

What you can do

  • Products: search, view, create, update, and delete products in your Wix Stores catalog.
  • Orders: look up an eCommerce order’s details, including line items, price summary, buyer, and payment and fulfilment status.
  • New-order events: trigger a process automatically when an order is placed.

Before you start

You need a Wix account with a site that has Wix Stores and Wix eCommerce, and permission to create an API key for that account.

Set up Wix

  1. Create an API key. Sign in to your Wix account and open the API Key Manager in your account settings, then create a new key.
  2. Grant permissions. Give the key the permissions it needs for Wix Stores (the product catalog) and Wix eCommerce (orders).
  3. Copy the key. Wix shows the key only once, so copy it right away.

Connect in metamorphOS

Activate the Wix connector from the marketplace, add an account, and provide:

  • API key: the key you generated above.
  • Site ID: the ID of the Wix site whose store and orders you want to drive. Each account can point at a different site, so supply the site ID for this account. For account-level use, provide your account ID here instead.

Receive new-order events

To trigger a process when an order is placed, register a new-order webhook in Wix:

  1. In your Wix app dashboard, open the Webhooks configuration.
  2. Subscribe to the Wix eCommerce -> Order Created event.
  3. Point the delivery URL at the address metamorphOS provides.

metamorphOS verifies the authenticity of every delivery, so you do not need to set a signing secret on the connector.

Good to know

  • The Order Created event fires when an order is created, which is not the same as payment. A brand-new order is often unpaid or pending, so check the order’s payment status before acting on payment, or gate on it downstream.
  • Product operations use Wix Stores Catalog V1, and the create action currently supports physical products only.
  • Field coverage is still expanding, so some advanced product and order fields may not be available yet.
Last updated on