> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Wix

> Access Wix site data - store products, eCommerce orders, and CRM contacts via the Wix REST API

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `WIX_API_KEY` is sent as the `Authorization` header.
* **Docs**: [https://dev.wix.com/docs/rest/articles/getting-started/api-keys](https://dev.wix.com/docs/rest/articles/getting-started/api-keys)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable      | Required | Description                                                                                                                                                             |
| ------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `WIX_API_KEY` | Yes      | Wix API key from the API Keys Manager (sent raw in the Authorization header, no Bearer prefix) [Docs](https://dev.wix.com/docs/rest/articles/getting-started/api-keys). |
| `WIX_SITE_ID` | Yes      | ID of the Wix site to operate on (visible in the site dashboard URL after /dashboard/) [Docs](https://dev.wix.com/docs/rest/articles/getting-started/api-keys).         |

## Setup

1. **Get a Wix site**: Use an existing Wix site or create a free one at [https://www.wix.com](https://www.wix.com) - add the Wix Stores app if you want to use the product and order tools. Note: the product tools target Stores Catalog V1; sites created from Q2 2025 onward typically use Catalog V3, where the stores/v1 endpoints do not work (a site supports either V1 or V3, never both).
2. **Create an API key**: As the account owner or co-owner, open the API Keys Manager ([https://manage.wix.com/account/api-keys](https://manage.wix.com/account/api-keys)), create a key, and grant it the permissions you need (e.g. Wix Stores, eCommerce, Contacts). Set the key as WIX\_API\_KEY.
3. **Find your site ID**: Open the site's dashboard - the site ID is the GUID in the URL after /dashboard/ (or use the Query Sites API). Set it as WIX\_SITE\_ID.
4. **Verify access**: Run the Query Products tool (empty body works) to confirm the key and site ID are wired correctly.

* The API key goes in the Authorization header as a raw value - no Bearer prefix
* Every site-level call also requires the wix-site-id header, which this connector sends automatically from WIX\_SITE\_ID
* Site-level calls only work with API keys generated from the site owner's account
* Stores v1 query endpoints take the filter as a stringified JSON value inside the query object
* The Query Products and Create Product tools use the Stores Catalog V1 API - on newer sites running Catalog V3 these endpoints fail; see the Catalog V1-to-V3 migration guide at [https://dev.wix.com/docs/api-reference](https://dev.wix.com/docs/api-reference) for the stores/v3 equivalents

Provider API reference: [https://dev.wix.com/docs/rest](https://dev.wix.com/docs/rest)

## Tools

| Tool               | Access | Description                                                                                |
| ------------------ | ------ | ------------------------------------------------------------------------------------------ |
| Query Products     | Read   | Query Wix Stores catalog products with filtering, sorting, and paging                      |
| Search Orders      | Read   | Search Wix eCommerce orders with filtering, sorting, and cursor paging                     |
| Get Order          | Read   | Get full details of a single eCommerce order, including line items, totals, and buyer info |
| Query Contacts     | Read   | Query CRM contacts with filtering, sorting, and paging (up to 1000 per request)            |
| Create Fulfillment | Write  | Mark eCommerce order line items as fulfilled, optionally with shipping tracking info       |
| Create Contact     | Write  | Create a new CRM contact with at least a name, email address, or phone number              |
| Create Product     | Write  | Create a new product in the Wix Stores catalog                                             |

## Example prompts

* Search my Wix store for the most recent orders and summarize their statuses and totals.
* Query my Wix Stores products and give me an overview of the catalog including prices and visibility.
* Query my Wix contacts to find a customer by name or email.
