Add Customer Tag
CustomersCan make changes
Add one or more tags to a customer using the tagsAdd mutation.
Shopify plugin
Shopify Admin API
Static-token Shopify Admin GraphQL provider. Tokens stay daemon-held; agents can only run curated action catalog operations.
Connection facts
What the Shopify Admin API connector actually exposes.
These details come from the current StackOS provider manifest and action catalog. They describe the available connection—not a promise that every workflow will use every action.
- Connection method
- api-token
- Setup
- Use an existing token from a Shopify custom app with only the scopes needed for the enabled actions.
- Capability groups
- Analytics, Customers, Inventory, Orders, Products
- Action boundaries
- 39 read actions19 write actions
Action catalog
Actions listed for Shopify Admin API.
Actions listed for this integration. Individual descriptions note availability limits. A workflow still decides which actions belong in the job and where approval is required.
58 matching actions
Add Order Note
OrdersCan make changes
Add or update a private note on an order.
Add Order Tag
OrdersCan make changes
Add one or more tags to an order.
Adjust Inventory
InventoryCan make changes
Adjust inventory quantity by a delta (positive to add, negative to subtract) at a specific location. Uses the inventoryAdjustQuantities mutation.
Conversion Funnel
AnalyticsReads data
Conversion funnel metrics: sessions, orders, customers, and ShopifyQL conversion_rate (values in shop currency)
Create Collection
ProductsCan make changes
Create a new collection with title and optional description.
Create Customer
CustomersCan make changes
Create a new customer with firstName, lastName, email, phone, tags, and note.
Create Draft Order
OrdersCan make changes
Create a draft order with line items, optional customer, shipping address, and note. Returns draft order with calculated totals.
Create Product
ProductsCan make changes
Create a new product with title, description, vendor, product type, status, and tags.
Create Product Variant
ProductsCan make changes
Add a variant to an existing product with price, SKU, and options. Options format: "OptionName:Value" (e.g. "Size:Large,Color:Red").
Customer Cohort Analysis
AnalyticsReads data
Customer cohort analysis showing customers, orders, and sales grouped by time period
Customer Lifetime Value
AnalyticsReads data
Customer lifetime value report from the ShopifyQL customers dataset showing customer_name, total_amount_spent, and total_orders. Note: groups by customer_name, which may not be unique across customers with the same name.
Discount Performance
AnalyticsReads data
Analyze discount impact on sales: discounted vs total revenue, discount percentage, and total discount amount
Get Collection
ProductsReads data
Get a single collection by its Shopify GID. Returns collection details with its products.
Get Customer
CustomersReads data
Get a single customer by ID with full detail including addresses, note, state, and createdAt.
Get Customer Lifetime Value
CustomersReads data
Get customer amountSpent, numberOfOrders, and first/last visible order dates. True first/last order history can require Shopify read_all_orders access beyond the default order window.
Get Customer Orders
CustomersReads data
List visible orders for a specific customer. Historical orders beyond Shopify's default order window can require read_all_orders access.
Get Inventory By Sku
InventoryReads data
Look up inventory items by SKU string. Uses the inventoryItems query with a SKU filter.
Get Inventory Item
InventoryReads data
Get an inventory item by its Shopify GID. Returns SKU, tracked status, and inventory levels per location with quantities.
Get Location Inventory
InventoryReads data
Get all inventory items at a specific location. Returns items with SKU, available, and incoming quantities.
Get Order
OrdersReads data
Get a single order by ID with customer, addresses, notes, tags, fulfillments, and the first 50 line items plus pagination metadata.
Get Order By Name
OrdersReads data
Get an order by its exact Shopify order name (for example, #1001 or a custom prefixed name). Uses Shopify order search by name.
Get Order Fulfillment Status
OrdersReads data
Get the fulfillment status of an order with tracking numbers, carrier, and tracking URLs for each fulfillment.
Get Order Timeline
OrdersReads data
Get the event timeline for an order (comments, status changes, fulfillments, refunds).
Get Product
ProductsReads data
Get a single product by its Shopify GID. Returns product detail with first 10 media and first 100 variants plus pagination metadata.
Get Product By Handle
ProductsReads data
Get a product by its URL handle (slug). Returns product detail with first 10 media and first 100 variants plus pagination metadata.
Get Product Variant
ProductsReads data
Get a single product variant by its Shopify GID. Returns full variant detail including price, SKU, and selected options.
Inventory Risk Report
AnalyticsReads data
Products at overstock or understock risk based on sales velocity
List Collections
ProductsReads data
List collections with cursor pagination. Returns collection title, handle, products count, and image.
List Customers
CustomersReads data
List customers with cursor pagination. Returns displayName, email, ordersCount, totalSpent, tags, and state.
List Inventory Levels
InventoryReads data
List inventory levels across all locations. Returns location name and available/committed/on_hand quantities. Supports cursor pagination.
List Orders
OrdersReads data
List visible orders with optional filtering by status, financial status, and fulfillment status. Returns order details including first-page line items, customer summary, and fulfillment tracking.
List Product Variants
ProductsReads data
List variants for a product with cursor pagination. Returns variant details including price, SKU, inventory, and selected options.
List Products
ProductsReads data
List products with optional filtering by status, vendor, and product type. Supports cursor pagination.
Low Stock Report
InventoryReads data
Get a report of inventory items below a specified stock threshold. Queries all inventory, filters items with available quantity below threshold, and returns a sorted list with product name, variant title, SKU, available quantity, and location.
Manage Product Tags
ProductsCan make changes
Add or remove tags on a product. Provide arrays of tags to add and/or remove.
Direct answer
How does the Shopify Admin API integration work?
People continue using Shopify Admin API as their tool. StackOS adds it to a visible workflow, keeps the work in order, and passes only the approved action to the integration when that stage is ready.
- 01Your requestStart in your AI
- 02StackOS planExpands the steps
- 03Shopify Admin APIDoes its bounded part
- 04Checked resultKeeps the proof
Common questions
Shopify Admin API and StackOS.
What can the Shopify Admin API integration do in StackOS?
The current catalog includes 58 Shopify Admin API actions across Analytics, Customers, Inventory, Orders, Products. The exact actions used depend on the workflow and approval rules.
Does StackOS replace Shopify Admin API?
No. Shopify Admin API remains the tool that performs its part of the job. StackOS organizes the workflow, keeps status and dependencies visible, and calls the tool only when the plan reaches the right approved action.