Skip to Content
IntegrationsShopify

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: look up an order’s details.
  • New-order events: trigger a process automatically when an order is placed.

Before you start

You need a Shopify store and permission to create a custom app in its admin (the store owner, or a staff account with app-development access).

Set up Shopify

  1. Create a custom app. In your Shopify admin, go to Settings → Apps and sales channels → Develop apps, then Create an app. Give it a name (for example, metamorphOS).
  2. Grant permissions. Open Configuration → Admin API integration and grant read and write access to Products and Orders, then save.
  3. Install and copy the token. On the API credentials tab, choose Install app, then reveal the Admin API access token (it starts with shpat_). Shopify shows it only once, so copy it right away.

Connect in metamorphOS

Activate the Shopify connector from the marketplace, add an account, and provide:

  • Admin API access token: the shpat_... token from the step above.
  • Store subdomain: your permanent *.myshopify.com subdomain (for example, acme for acme.myshopify.com), not a custom storefront domain. Each account can point at a different store.

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. Supply the app’s API secret key (on the API credentials tab) as the connector’s webhook signing secret; metamorphOS rejects any delivery that fails verification.

Good to know

  • 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.
Last updated on
sevDeskSlack