Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.
VariableRequiredDescription
WIX_API_KEYYesWix API key from the API Keys Manager (sent raw in the Authorization header, no Bearer prefix) Docs.
WIX_SITE_IDYesID of the Wix site to operate on (visible in the site dashboard URL after /dashboard/) Docs.

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.
  • 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: https://dev.wix.com/docs/rest

Tools

ToolAccessDescription
Query ProductsReadQuery Wix Stores catalog products with filtering, sorting, and paging
Search OrdersReadSearch Wix eCommerce orders with filtering, sorting, and cursor paging
Get OrderReadGet full details of a single eCommerce order, including line items, totals, and buyer info
Query ContactsReadQuery CRM contacts with filtering, sorting, and paging (up to 1000 per request)
Create FulfillmentWriteMark eCommerce order line items as fulfilled, optionally with shipping tracking info
Create ContactWriteCreate a new CRM contact with at least a name, email address, or phone number
Create ProductWriteCreate 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.