First-party app
Wix Wix

Wix

Manage a Wix site's CMS collections and data items, contacts and labels, Stores products, and eCommerce orders via the Wix REST API.

stable Content ManagementCustomer Relationship ManagementCommerce & Payments

About

Wix ships in the w6w first-party pack. It declares 24 actions, 2 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.wix
Version
0.1.5
Author
w6w
Licence
MIT
Categories
Content Management · Customer Relationship Management · Commerce & Payments

Overview

Wix is a website builder and hosting platform, and this app manages the content and customer data of a Wix site — its CMS collections and data items, its contacts, and its Stores catalog and eCommerce orders — over the Wix REST API.

It covers the full record lifecycle for Wix Data, Wix’s built-in CMS: list, query, get, insert, update, remove, count and bulk-insert items in any collection a site has defined. Contacts can be listed, queried, created, updated, deleted and labeled, and Stores products and eCommerce orders can be read to keep an external system in sync with what a site is selling.

Good for syncing form submissions or leads into a site’s CMS collections, keeping contact records and labels current from another system, pulling new eCommerce orders into fulfillment or accounting, and reading a site’s product catalog into a workflow that needs current inventory or pricing.

Build with Wix

Three routes to the same 24 actions. The Workflow tab is generated from Wix's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Bulk Insert Data Items

bulk-insert-data-items

Insert many items into a CMS collection in one call. Wix reports per-item results, so a partial failure is normal — read `results` rather than assuming all-or-nothing.

Count Data Items

count-data-items

Count the items in a CMS collection matching a filter, without transferring them. Cheaper than a query when only the number matters.

Create Contact

create-contact

Create a contact. Wix requires at least one of name, email or phone, and rejects a duplicate email or phone unless you allow duplicates.

Delete Contact

delete-contact

Delete a contact. Wix soft-deletes to a trash bin with a 90-day recovery window; a contact who is also a site member must be removed through the Members API instead.

Get Collection

get-collection

Retrieve one CMS collection, including its field definitions — the way to discover a collection's field names and types before writing items into it.

Get Contact

get-contact

Retrieve a single contact by id, including the `revision` that Update Contact requires.

Get Data Item

get-data-item

Retrieve a single item from a CMS collection by its id.

Get Order

get-order

Retrieve a single eCommerce order by id, including line items, buyer info, totals and payment status.

Get Product

get-product

Retrieve a single Wix Stores product by id.

Get Site Properties

get-site-properties

Read the connected site's own properties — display name, locale, time zone, currency, business contact and schedule.

Insert Data Item

insert-data-item

Insert a new item into a CMS collection.

Label Contact

label-contact

Add one or more labels to a contact. The labels must already exist — create them with Find or Create Label first.

List Collections

list-collections

List the site's CMS data collections. Start here — a collection's id is what every data-item action needs.

List Contacts

list-contacts

List the site's contacts in a simple sorted page. Use Query Contacts when you need to filter.

List Labels

list-labels

List the contact labels defined on the site. Label Contact needs a label's `key`, and this is where to find it.

Query Contacts

query-contacts

Find contacts by filter, plain-text search, sort and paging. Up to 1,000 per request; Wix defaults to 50.

Query Data Items

query-data-items

Query a CMS collection with a filter, sort and paging. The main read path for Wix Data.

Query Products

query-products

Query the Wix Stores catalog (Catalog V3). Cursor-paged — pass the previous response's `pagingMetadata.cursors.next` to continue.

Query Sites

query-sites

List the sites in the Wix account — the way to discover the site IDs every other action needs. Account-level: requires the connection's Account ID rather than its Site ID.

Remove Data Item

remove-data-item

Permanently delete an item from a CMS collection.

Search Orders

search-orders

Search the site's eCommerce orders by filter, free text, sort and cursor paging. Wix exposes no offset-paged list for orders — this is the read path.

Unlabel Contact

unlabel-contact

Remove one or more labels from a contact. The label itself is not deleted, only its association with this contact.

Update Contact

update-contact

Update a contact. Requires the contact's current `revision` — read it with Get Contact first; a stale revision is rejected rather than silently overwriting a concurrent change.

Update Data Item

update-data-item

Replace a CMS item's contents. This is a full replace, not a merge — omitted fields are cleared.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Wix's real ids.

{
  "manifestVersion": "2",
  "name": "wix-example",
  "steps": [
    {
      "id": "bulk-insert-data-items",
      "uses": {
        "app": "io.w6w.wix",
        "action": "bulk-insert-data-items",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "dataCollectionId": "<dataCollectionId>",
        "dataItems": "<dataItems>"
      }
    }
  ]
}

Here are some of the things you can do

  • Bulk Insert Data Items

    perform
    bulk-insert-data-items
  • Count Data Items

    read
    count-data-items
  • Create Contact

    perform
    create-contact
  • Get Collection

    read
    get-collection
  • Get Contact

    read
    get-contact

+19 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Wix, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Wix. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "create-contact",
  payload: {
    // info: "<value>",
    // firstName: "<value>",
    // lastName: "<value>",
    // email: "<value>",
    // phone: "<value>",
    // company: "<value>",
    // jobTitle: "<value>",
    // labelKeys: "<value>",
    // allowDuplicates: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action create-contact --payload '{}'

Give an AI agent Wix — without giving it Wix's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.wix#bulk-insert-data-items",
    "input": {
      "dataCollectionId": "<dataCollectionId>",
      "dataItems": "<dataItems>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Wix connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Wix's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Wix itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Wix declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Wix platform status

Atlassian Statuspage rollup for status.wix.com, with per-component detail across the Wix product surface (Editor, Dashboard, Payments, Storefront, Automations, …). Unauthenticated and unsigned.

quota

API rate-limit headroom