Connect your app to WooCommerce
WooCommerce 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.
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
- Sign in to the store’s WordPress admin.
- Open WooCommerce → Settings → Advanced → REST API.
- Choose Add key or Create an API key.
- Enter a description, such as
Mythos store tools, and select the WordPress user the key should belong to. - Choose Read for dashboards and lookups, or Read/Write if the app will change products, orders, customers, coupons, or other supported records.
- 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 for the provider’s setup details.
2. Save the connection
- From the Dashboard, open Connectors and select WooCommerce. If no saved connection is available, the setup form opens.
- Enter a Display name, such as
Main store. - In Shop address, enter the hostname without
https://or a port. For example, useshop.example.com. If WordPress is installed in a subdirectory, include it:example.com/store. - Paste the
ck_value into Consumer key and the matchingcs_value into Consumer secret. Keep these values out of chat messages. - Under Sharing, keep Private or choose Share with others. Select individual workspace members, or use Share with workspace.
- 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 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.