Shopify Integration

This guide explains how to connect Shopify to Supervity, what data is available after connection, how operators can use Shopify data and actions within workflows, and how to remove the integration when needed.

---

Overview

The Supervity Shopify integration allows your workspace to securely connect Shopify as a governed platform capability.

Once connected, operators and workflows can use Shopify data and actions to manage store listings, retrieve and update customer orders, sync stock levels, compile customer lists, and streamline order fulfillments.

With the Shopify integration, Supervity can:

• List and view products, including creating, updating, or deleting listings
• List and view orders, including creating, updating, closing, or canceling orders
• Manage customer profiles, details, and search query attributes
• Track and adjust inventory levels across different locations
• Create, update, and manage custom collections
• Manage fulfillments, tracking information, and fulfillment orders
• Retrieve product variants and location configurations
• Use Shopify data as context for operators
• Trigger workflows based on store activity

All Shopify access is governed through Supervity's security, permissions, and audit controls.

---

Prerequisites

Before connecting Shopify, ensure you have:

• An active Supervity workspace
• An active Shopify store (live production store OR a development/sandbox store)
• Staff or administrator permissions on the Shopify store to authorize apps
• The shop's domain (e.g.mystore.myshopify.com)

---

Adding the Shopify Integration

Follow these steps to connect Shopify to Supervity. If you encounter any issues during setup, refer to the Troubleshooting section of this guide.

Step 1: Open Integrations

1. Log in to Supervity.
2. From the left navigation bar, click the Integrations icon.

This opens the Integrations page, where all available integrations are listed.

Step 2: Select Shopify

1. Locate Shopify in the available integrations list.
2. Click Connect.

Step 3: Enter Shop Domain

In the connection dialog, enter your Shopify store domain. You must enter the full .myshopify.com domain (e.g., mystore.myshopify.com or with the https:// prefix, such as https://mystore.myshopify.com). Entering only the subdomain identifier (e.g., mystore) is not supported.

Click Connect to proceed.

Step 4: Authorize Access

You will be redirected to the secure Shopify admin authorization page.

Review the requested permissions and click Install app (or Allow) to grant Supervity access to your store.

• Supervity uses Shopify's standard OAuth 2.0 authorization flow.
• Your Shopify credentials are never shared with or stored by Supervity.

Step 5: Complete Connection

After authorization, you will be redirected back to Supervity.

The Shopify integration will appear as Connected on the Integrations page. Your workspace can now securely access Shopify capabilities according to the permissions granted.

---

How Shopify Works in Supervity

After connection, Shopify becomes available as a governed platform tool.

Operators can use Shopify capabilities when planning and executing tasks, while workflows can automate actions using Shopify data.

Common use cases include:

• Syncing catalog items with internal databases or external marketplaces
• Automating draft order creation for wholesale clients
• Moderating customer records and syncing lists with CRM platforms
• Keeping inventory levels synchronized across multi-channel stores
• Automatically updating shipping tracking details

---

Using Shopify in Operators

Connected Shopify capabilities become available to operators automatically. Operators determine when Shopify data or actions are required to complete a task and execute accordingly, while remaining governed by workspace permissions, security controls, and approval policies.

What Operators Can Do with Shopify

Operators can perform the following actions using Shopify:

• List, fetch, create, update, and delete products
• List, fetch, create, update, cancel, and close orders
• List, search, fetch, create, update, and delete customer profiles
• View and adjust stock quantities and inventory levels
• Create, modify, and delete custom product collections
• List, create, update, and cancel fulfillments and tracking info
• List, create, update, and delete product variants
• Query store locations and configuration details

Typical Operator Use Cases

---

Features & Prerequisites

For each Shopify capability available in Supervity, the following describes the use case and the prerequisites required before use.

Product Operations

Use Case: Retrieve lists of products, get product details, create new listings, update existing descriptions/pricing, or delete items from the catalog.

Prerequisites:

• Shopify store connected to Supervity
• Products exist in the store catalog

---

Order Operations

Use Case: Retrieve orders, fetch order details, generate orders, edit mutable order fields, cancel orders, or mark orders as closed.

Prerequisites:

• Shopify store connected to Supervity
• Appropriate store permissions to manage orders

---

Customer Operations

Use Case: List customers, find customer entries via query attributes, retrieve profiles, create new customer cards, update details, or delete entries.

Prerequisites:

• Shopify store connected to Supervity

---

Inventory Operations

Use Case: Retrieve inventory levels across locations, adjust stock amounts by a relative number, or override levels to an absolute value.

Prerequisites:

• Shopify store connected to Supervity
• Configured store locations and inventory items

---

Collection Operations

Use Case: List custom collections, fetch specific collection data, or create, update, and delete collections.

Prerequisites:

• Shopify store connected to Supervity

---

Fulfillment Operations

Use Case: List order fulfillments, fetch specific fulfillment items, draft new fulfillments, update tracking references, or cancel active fulfillments.

Prerequisites:

• Shopify store connected to Supervity
• Order must exist and be in a partially fulfilled or unfulfilled state

---

Variant Operations

Use Case: List all variants of a product, view variant details, or create, modify, and delete variant entries (like sizes, colors, and SKUs).

Prerequisites:

• Shopify store connected to Supervity
• Target product must exist in the store

---

Location Operations

Use Case: Retrieve configured warehouse and shop location lists or get a specific location's details.

Prerequisites:

• Shopify store connected to Supervity

---

Permissions Requested

Supervity only requests the permissions required for enabled Shopify capabilities.

Depending on the features used in your workspace, permissions may include:

Supervity follows least-privilege principles and only accesses data necessary to provide requested functionality.

---

Authentication & Security

The Shopify integration uses OAuth 2.0 authentication.

Security controls include:

• Encrypted credential storage (AES-256)
• Least-privilege access scopes
• Token refresh and rotation support
• Immediate revocation capabilities
• Workspace-level governance controls
• Complete audit logging
• TLS 1.3 for all API connections

All Shopify access remains subject to Supervity security policies and role-based permissions.

---

Managing the Integration

View Connection Status

From the left navigation bar, click the Integrations icon.

For Shopify you can view:

• Connection status
• Connected store domain
• Last usage information
• Associated workflows and operators

Reconnect Shopify

If Shopify authorization expires:

1. Open the Integrations page from the left navigation bar.
2. Select Shopify.
3. Click Reconnect.
4. Complete authorization again.

Existing workflows and operators do not need to be recreated.

Removing the Shopify Integration

You can remove the Shopify connection from your Supervity workspace at any time.

Steps to Remove

1. Log in to Supervity.
2. From the left navigation bar, click the Integrations icon.
3. Locate and select Shopify from the integrations list.
4. Click Disconnect.
5. Confirm the action when prompted.

Implications of Removal

Once removed:

• Supervity immediately loses all access to your Shopify store and data
• No new Shopify data will be read or processed
• All active Shopify connections are terminated
• Workflows that depend on Shopify will stop executing and fail safely
• Historical execution logs remain available for auditing purposes

Disconnecting Shopify does not delete workflow definitions, operators, or previously generated outputs.

---

Troubleshooting

Shop Domain Verification Failed

Likely Cause: Incorrect shop domain entered during the connection step.

Resolution:

1. Ensure you enter the full .myshopify.com domain (e.g., mystore.myshopify.com or https://mystore.myshopify.com). Entering only the subdomain (e.g., mystore) is not supported.
2. Do not include http:// or subfolders in the domain field (though https:// is supported).
3. Confirm that the store is currently online and active.

---

Authorization Failed During Setup

Likely Cause: Incorrect Shopify store or account used, or insufficient permissions to authorize applications.

Resolution:

1. Ensure you are signed in to the correct Shopify store as an owner or administrator.
2. Confirm your Shopify user account has permission to install and authorize applications.
3. Return to Supervity → Integrations → Shopify and click Connect to retry.
4. If the issue persists, contact your Shopify store administrator.

---

Missing Inventory or Fulfillments

Likely Cause: Insufficient permissions on the connected staff or admin account.

Resolution:

1. Ensure the Shopify user account used during authorization has permissions to view and manage inventory and fulfillments.
2. Reconnect the integration using an Administrator account to grant full permissions.

---

Frequently Asked Questions

Q: Can I connect multiple Shopify stores to Supervity?

Yes. Each connected account is authenticated independently. You can configure and connect multiple Shopify stores in your workspace settings.

---

Q: Does Supervity store my Shopify password?

No. Authentication is handled completely via standard OAuth 2.0. Supervity only receives and stores securely encrypted access tokens.

---

Q: Does the integration support custom apps or public apps?

This integration uses the standard Shopify OAuth flow, which connects as a custom or public app channel using your store credentials.

Support

If you need assistance with the Shopify integration, visit the Support page.

Support Hours

• Monday to Friday, 9:00 AM – 6:00 PM IST
• Requests submitted outside business hours will be addressed on the next business day

First Response SLA

• All support requests receive an initial response within 24 business hours

Contact Information

When Contacting Support, Please Provide

• Workspace name
• Connected store domain URL
• Relevant workflow or operator information
• Error messages or screenshots when available

This helps the support team investigate and resolve issues more quickly.

---

Related Documentation

• Integrations Overview
• OAuth2
• Security & Privacy
• Supervity Website