> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mythos.new/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mythos.new/_mcp/server.

# Connect your app to WooCommerce

> Build store dashboards, inventory tools, and order workflows using your WooCommerce products and customers.

[WooCommerce](https://woocommerce.com/) turns a WordPress site into an online store. Connect an existing store to Mythos when you want a custom operations dashboard, a focused catalog editor, or a customer-service tool using the data already in WooCommerce.

The connection uses a **WooCommerce REST API consumer key and consumer secret**. It is available in the project chat while building and in your published app. The key's permissions and its WordPress user determine what the app can do.

With WooCommerce, you can:

* Read products, variations, orders, customers, coupons, and sales reports.
* Build inventory views and update supported product details.
* Create or update supported store records with a Read/Write key.
* Work with order notes, refunds, reviews, and order emails.
* Use shipping-zone and other supported store information in a custom workflow.

## Examples to build

These prompts describe apps Mythos can create around your existing store. The connector provides access to store data; it does not replace the store's hosting or install WooCommerce for you.

| App idea          | Prompt to try                                                                                                   | What it adds                                                      |
| ----------------- | --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| Daily operations  | *Build a WooCommerce dashboard showing today's orders, low-stock products, and orders waiting for fulfillment.* | A focused overview of the work that needs attention.              |
| Inventory editor  | *List products and variations by stock status and let authorized staff update quantities.*                      | A stock-management interface without the rest of WordPress admin. |
| Support console   | *Let support staff search customers, review their orders, and prepare a refund for confirmation.*               | A customer-service workflow using existing purchase records.      |
| Coupon manager    | *Build a page for reviewing coupons, creating new codes, and seeing their usage.*                               | A tailored promotion-management tool.                             |
| Catalog editor    | *Show product descriptions, prices, and categories in an editable table with a review step before saving.*      | A focused interface for catalog changes.                          |
| Fulfillment queue | *Group open orders by status and highlight orders older than our target dispatch time.*                         | An operations view based on your store's dates and statuses.      |
| Sales report      | *Compare sales by product and coupon over a selected period and let staff export the results.*                  | A custom report built from the store information you can access.  |

For tools that change inventory, orders, or money, describe who may use each action and what confirmation the app should show. Connection sharing does not create those staff permissions inside the app.

## Connect WooCommerce to Mythos

You need an existing store, access to its WooCommerce settings, and permission to create connections in your Mythos workspace. If your team has already shared the right store connection with you, use that saved connection.

### Before you start

Check that:

* The store is reachable over HTTPS.
* WordPress permalinks use a format other than **Plain**.
* The store's WooCommerce REST API is available.
* You have a consumer key and its matching consumer secret.

Your hosting, store extensions, and other WooCommerce costs remain outside Mythos. API activity runs against your own store and is subject to its capacity and configuration.

### 1. Create a REST API key

1. Sign in to the store's WordPress admin.
2. Open **WooCommerce → Settings → Advanced → REST API**.
3. Choose **Add key** or **Create an API key**.
4. Enter a description, such as `Mythos store tools`, and select the WordPress user the key should belong to.
5. Choose **Read** for dashboards and lookups, or **Read/Write** if the app will change products, orders, customers, coupons, or other supported records.
6. Generate the key and copy both the **Consumer key** and **Consumer secret**. The secret is only shown once.

Keep both values secure. See WooCommerce's [REST API key instructions](https://woocommerce.com/document/woocommerce-rest-api/) for the provider's setup details.

### 2. Save the connection

1. From the Dashboard, open **Connectors** and select **WooCommerce**. If no saved connection is available, the setup form opens.
2. Enter a **Display name**, such as `Main store`.
3. In **Shop address**, enter the hostname without `https://` or a port. For example, use `shop.example.com`. If WordPress is installed in a subdirectory, include it: `example.com/store`.
4. Paste the `ck_` value into **Consumer key** and the matching `cs_` value into **Consumer secret**. Keep these values out of chat messages.
5. Under **Sharing**, keep **Private** or choose **Share with others**. Select individual workspace members, or use **Share with workspace**.
6. Click **Connect WooCommerce**. Mythos checks that it can read products from the store.

In your project, open **Chat actions (+) → Project connectors**, select the saved WooCommerce connection, and click **Use in this project**. Then ask Mythos to build the store tool. See [Connections in Mythos](/integrations/introduction) for project access and sharing.

A useful first prompt is:

> Build a read-only dashboard of my WooCommerce products and recent orders, with filters for stock and order status.

Once you have the intended view, ask for the particular editing workflow your staff needs.

## Permissions and connection errors

A **Read** key can power reports, product lists, and lookups. Changes require **Read/Write** permission and a WordPress user authorized for the action. A successful product read does not prove that a refund or order update is allowed.

If setup returns a route error, check the **Shop address**, including any WordPress subdirectory. Confirm that WooCommerce is active and that **Settings → Permalinks** is not set to **Plain**. The connection uses the store's WooCommerce REST API, not the WordPress admin address.

If authentication fails, check that the consumer key and secret belong to the same store and were generated together. If reads work but writes fail, check the key's permissions before changing the app.

## Limitations

* The connector does not create REST API keys or change their permissions. Manage them in WordPress admin.
* It does not configure store hosting, HTTPS, WordPress permalinks, or plugins.
* Its store actions use the WooCommerce REST API; it is not a general WordPress administration connection.
* Each saved connection uses one store credential pair. App visitors do not sign in to their own WooCommerce stores through it.
* Keys do not rotate automatically in Mythos. New credentials must be saved before the app can use them.

## Manage the store connection

Open **Connectors → WooCommerce**, then your saved connection. **Linked projects → Unlink projects** removes selected project links. **Disconnect** stops Mythos from using this connection; it does not delete the store, its products, or its order history.

If you generate a new credential pair in WooCommerce, disconnect the old connection and connect again using both matching values. Link the new connection to the intended projects, ask Mythos to set up the affected app features again, and publish. Features using the disconnected connection stop working until they are set up again.