Skip to main content

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from WIX_API_KEY is sent as the Authorization header.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

Setup

  1. Get a Wix site: Use an existing Wix site or create a free one at 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), 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.

Provider notes

  • 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 for the stores/v3 equivalents
Provider API reference.

Tools

Verify the connection

Call a read tool such as wix__query_products with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.