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
- 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.
- Grant permissions. Give the key the permissions it needs for Wix Stores (the product catalog) and Wix eCommerce (orders).
- 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:
- In your Wix app dashboard, open the Webhooks configuration.
- Subscribe to the Wix eCommerce -> Order Created event.
- 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