Shopify
Connect a Shopify store to manage its product catalog and react to new orders. metamorphOS calls the Shopify Admin API to list and edit products, and Shopify notifies metamorphOS by webhook whenever a customer places an order.
What you can do
- Products: list, view, create, update, and delete products in your catalog.
- Orders: search orders, look up one order’s details, and read its payments.
- New-order events: trigger a process automatically when an order is placed.
Connect your store
Activate the Shopify connector from the marketplace and add an account. You will
be asked for your store subdomain - the permanent *.myshopify.com one (for
example, acme for acme.myshopify.com), not a custom storefront domain. Each
account can point at a different store.
Then choose Connect. Shopify asks you to approve the access metamorphOS needs - products and orders - and returns you to metamorphOS once you accept. That is the whole setup: there is no app to create and no token to copy.
You need permission to install apps on the store, which the store owner has by default.
Receive new-order events
To trigger a process when an order is placed, register an order-creation webhook:
- Automatically: run the connector’s create-webhook action, which subscribes to order-creation events and points them at metamorphOS.
- Manually: in Settings → Notifications → Webhooks, add an Order creation webhook (JSON format) pointing at the URL metamorphOS provides.
Shopify signs each delivery so metamorphOS can confirm it is genuine, and rejects any delivery that fails verification.
Good to know
- Access stays active as long as the app remains installed. Uninstalling it from your Shopify admin revokes metamorphOS’s access immediately.
- Orders older than 60 days are not readable by default. Reading full order history needs additional permission, which Shopify grants on request - ask before relying on a backfill.
- Product operations use Shopify’s current GraphQL Admin API; the older REST product endpoints are deprecated.
- Field coverage is still expanding, so some advanced product fields may not be available yet.