Use Shopify to manage products, orders, customers, inventory, and fulfillments. The reference below covers location and collection lookups as well as store mutations.
Connection guides: Admin API tokens .
Sim requests these scopes when someone connects a Shopify account. For a self-hosted deployment, register your own app with the provider using the settings below. See Integrations and OAuth for setup.
Setting Value Redirect URI <NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/shopifyEnvironment variables SHOPIFY_CLIENT_ID, SHOPIFY_CLIENT_SECRET
Scope Description write_productsRead and manage Shopify products write_ordersRead and manage Shopify orders write_customersRead and manage Shopify customers write_inventoryRead and manage Shopify inventory levels read_locationsView store locations write_merchant_managed_fulfillment_ordersRead and fulfill orders assigned to merchant-managed locations
Manage Shopify products and variants, orders, customers, inventory, collections, and merchant-managed fulfillment using Admin GraphQL API 2026-10. Discover fulfillment orders, ship selected items, update tracking, and check cancellation jobs. Continue list and nested results with the returned cursors. Product activation does not publish to sales channels. Orders normally cover the last 60 days; older orders and protected customer fields require Shopify approval and access. Expanded list details are optional and use smaller pages to stay within query-cost limits. Expanded order-update responses are opt-in and require product, protected-address, and fulfillment access.
Create a new product in your Shopify store
Inputs and outputsParameter Type Required Description handlestring No URL-friendly product handle seojson No SEOInput object with title and description categorystring No Product taxonomy category GID templateSuffixstring No Theme template suffix metafieldsarray No MetafieldInput array: namespace, key, type, value, or id collectionsToJoinarray No Collection GIDs to add the product to requiresSellingPlanboolean No Whether a selling plan is required to purchase the product productOptionsarray No OptionCreateInput array with name and values: [{name: "Size", values: [{name: "Small"}]}] mediaarray No CreateMediaInput array with originalSource, mediaContentType, and optional alt shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) titlestring Yes Product title descriptionHtmlstring No Product description (HTML) vendorstring No Product vendor/brand productTypestring No Product type/category tagsarray No Product tags statusstring No Product status (ACTIVE, DRAFT, ARCHIVED, UNLISTED)
Parameter Type Description productobject The created product ↳ templateSuffix string Theme template suffix ↳ requiresSellingPlan boolean Whether purchasing requires a selling plan ↳ category object Product taxonomy category ↳ id string Taxonomy category GID ↳ fullName string Category path ↳ id string Unique product identifier (GID) ↳ title string Product title ↳ handle string URL-friendly product identifier ↳ seo object Search engine listing ↳ title string SEO title ↳ description string SEO description ↳ onlineStoreUrl string Online store URL, null when not published ↳ options array Product options ↳ id string Option GID ↳ name string Option name ↳ position number Option position ↳ values array Option values ↳ descriptionHtml string Product description in HTML format ↳ vendor string Product vendor or manufacturer ↳ productType string Product type classification ↳ tags array Product tags for categorization ↳ status string Product status (ACTIVE, DRAFT, ARCHIVED, UNLISTED) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ variants object Product variants page; use Get Product with variantsAfter for subsequent pages ↳ pageInfo object Variant pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Array of variant edges ↳ node object Variant node ↳ id string Unique variant identifier (GID) ↳ title string Variant title ↳ price string Variant price ↳ barcode string Variant barcode ↳ taxable boolean Whether the variant is taxable ↳ inventoryPolicy string Inventory policy (DENY or CONTINUE) ↳ inventoryItem object Inventory item for stock operations ↳ id string Inventory item GID ↳ sku string SKU ↳ tracked boolean Whether stock is tracked ↳ selectedOptions array Selected product options ↳ name string Option name ↳ value string Selected value ↳ compareAtPrice string Compare at price ↳ sku string Stock keeping unit ↳ inventoryQuantity number Available inventory quantity ↳ images object Product images page; use Get Product with imagesAfter for subsequent pages ↳ pageInfo object Image pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Array of image edges ↳ node object Image node ↳ id string Unique image identifier (GID) ↳ url string Image URL ↳ altText string Alternative text for accessibility
Get a single product by ID from your Shopify store
Inputs and outputsParameter Type Required Description variantsFirstnumber No Maximum variants in this page (default 50, max 100) variantsAfterstring No Cursor from variants.pageInfo.endCursor for the next page imagesFirstnumber No Maximum images in this page (default 20, max 100) imagesAfterstring No Cursor from images.pageInfo.endCursor for the next page shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) productIdstring Yes Product ID (gid://shopify/Product/123456789)
Parameter Type Description productobject The product details ↳ templateSuffix string Theme template suffix ↳ requiresSellingPlan boolean Whether purchasing requires a selling plan ↳ category object Product taxonomy category ↳ id string Taxonomy category GID ↳ fullName string Category path ↳ id string Unique product identifier (GID) ↳ title string Product title ↳ handle string URL-friendly product identifier ↳ seo object Search engine listing ↳ title string SEO title ↳ description string SEO description ↳ onlineStoreUrl string Online store URL, null when not published ↳ options array Product options ↳ id string Option GID ↳ name string Option name ↳ position number Option position ↳ values array Option values ↳ descriptionHtml string Product description in HTML format ↳ vendor string Product vendor or manufacturer ↳ productType string Product type classification ↳ tags array Product tags for categorization ↳ status string Product status (ACTIVE, DRAFT, ARCHIVED, UNLISTED) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ variants object Product variants page; use Get Product with variantsAfter for subsequent pages ↳ pageInfo object Variant pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Array of variant edges ↳ node object Variant node ↳ id string Unique variant identifier (GID) ↳ title string Variant title ↳ price string Variant price ↳ barcode string Variant barcode ↳ taxable boolean Whether the variant is taxable ↳ inventoryPolicy string Inventory policy (DENY or CONTINUE) ↳ inventoryItem object Inventory item for stock operations ↳ id string Inventory item GID ↳ sku string SKU ↳ tracked boolean Whether stock is tracked ↳ selectedOptions array Selected product options ↳ name string Option name ↳ value string Selected value ↳ compareAtPrice string Compare at price ↳ sku string Stock keeping unit ↳ inventoryQuantity number Available inventory quantity ↳ images object Product images page; use Get Product with imagesAfter for subsequent pages ↳ pageInfo object Image pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Array of image edges ↳ node object Image node ↳ id string Unique image identifier (GID) ↳ url string Image URL ↳ altText string Alternative text for accessibility
List products from your Shopify store with optional filtering
Inputs and outputsParameter Type Required Description includeDetailsboolean No Include expanded nested details; uses a smaller page limit to stay within Shopify query costs reverseboolean No Reverse the result sort order (default false) sortKeystring No Sort results by CREATED_AT, ID, INVENTORY_TOTAL, PRODUCT_TYPE, PUBLISHED_AT, RELEVANCE, TITLE, UPDATED_AT, VENDOR (default Shopify ordering) shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) afterstring No Cursor from pageInfo.endCursor to retrieve the next page firstnumber No Number of products to return (default: 50, max: 250; with includeDetails: default/max 20) querystring No Search query to filter products (e.g., "title:shirt" or "vendor:Nike" or "status:active")
Parameter Type Description productsarray List of products ↳ templateSuffix string Theme template suffix ↳ requiresSellingPlan boolean Whether purchasing requires a selling plan ↳ category object Product taxonomy category ↳ id string Taxonomy category GID ↳ fullName string Category path ↳ id string Unique product identifier (GID) ↳ title string Product title ↳ handle string URL-friendly product identifier ↳ seo object Search engine listing ↳ title string SEO title ↳ description string SEO description ↳ onlineStoreUrl string Online store URL, null when not published ↳ options array Product options ↳ id string Option GID ↳ name string Option name ↳ position number Option position ↳ values array Option values ↳ descriptionHtml string Product description in HTML format ↳ vendor string Product vendor or manufacturer ↳ productType string Product type classification ↳ tags array Product tags for categorization ↳ status string Product status (ACTIVE, DRAFT, ARCHIVED, UNLISTED) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ variants object Product variants page; use Get Product with variantsAfter for subsequent pages ↳ pageInfo object Variant pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Array of variant edges ↳ node object Variant node ↳ id string Unique variant identifier (GID) ↳ title string Variant title ↳ price string Variant price ↳ barcode string Variant barcode ↳ taxable boolean Whether the variant is taxable ↳ inventoryPolicy string Inventory policy (DENY or CONTINUE) ↳ inventoryItem object Inventory item for stock operations ↳ id string Inventory item GID ↳ sku string SKU ↳ tracked boolean Whether stock is tracked ↳ selectedOptions array Selected product options ↳ name string Option name ↳ value string Selected value ↳ compareAtPrice string Compare at price ↳ sku string Stock keeping unit ↳ inventoryQuantity number Available inventory quantity ↳ images object Product images page; use Get Product with imagesAfter for subsequent pages ↳ pageInfo object Image pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Array of image edges ↳ node object Image node ↳ id string Unique image identifier (GID) ↳ url string Image URL ↳ altText string Alternative text for accessibility pageInfoobject Pagination information ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page
Update an existing product in your Shopify store
Inputs and outputsParameter Type Required Description handlestring No URL-friendly product handle seojson No SEOInput object with title and description categorystring No Product taxonomy category GID templateSuffixstring No Theme template suffix metafieldsarray No MetafieldInput array: namespace, key, type, value, or id collectionsToJoinarray No Collection GIDs to add the product to requiresSellingPlanboolean No Whether a selling plan is required to purchase the product collectionsToLeavearray No Collection GIDs to remove the product from redirectNewHandleboolean No Create a redirect when changing the handle mediaarray No CreateMediaInput array with originalSource, mediaContentType, and optional alt shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) productIdstring Yes Product ID to update (gid://shopify/Product/123456789) titlestring No New product title descriptionHtmlstring No New product description (HTML) vendorstring No New product vendor/brand productTypestring No New product type/category tagsarray No New product tags statusstring No New product status (ACTIVE, DRAFT, ARCHIVED, UNLISTED)
Parameter Type Description productobject The updated product ↳ templateSuffix string Theme template suffix ↳ requiresSellingPlan boolean Whether purchasing requires a selling plan ↳ category object Product taxonomy category ↳ id string Taxonomy category GID ↳ fullName string Category path ↳ id string Unique product identifier (GID) ↳ title string Product title ↳ handle string URL-friendly product identifier ↳ seo object Search engine listing ↳ title string SEO title ↳ description string SEO description ↳ onlineStoreUrl string Online store URL, null when not published ↳ options array Product options ↳ id string Option GID ↳ name string Option name ↳ position number Option position ↳ values array Option values ↳ descriptionHtml string Product description in HTML format ↳ vendor string Product vendor or manufacturer ↳ productType string Product type classification ↳ tags array Product tags for categorization ↳ status string Product status (ACTIVE, DRAFT, ARCHIVED, UNLISTED) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ variants object Product variants page; use Get Product with variantsAfter for subsequent pages ↳ pageInfo object Variant pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Array of variant edges ↳ node object Variant node ↳ id string Unique variant identifier (GID) ↳ title string Variant title ↳ price string Variant price ↳ barcode string Variant barcode ↳ taxable boolean Whether the variant is taxable ↳ inventoryPolicy string Inventory policy (DENY or CONTINUE) ↳ inventoryItem object Inventory item for stock operations ↳ id string Inventory item GID ↳ sku string SKU ↳ tracked boolean Whether stock is tracked ↳ selectedOptions array Selected product options ↳ name string Option name ↳ value string Selected value ↳ compareAtPrice string Compare at price ↳ sku string Stock keeping unit ↳ inventoryQuantity number Available inventory quantity ↳ images object Product images page; use Get Product with imagesAfter for subsequent pages ↳ pageInfo object Image pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Array of image edges ↳ node object Image node ↳ id string Unique image identifier (GID) ↳ url string Image URL ↳ altText string Alternative text for accessibility
Delete a product from your Shopify store
Inputs and outputsParameter Type Required Description shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) productIdstring Yes Product ID to delete (gid://shopify/Product/123456789)
Parameter Type Description deletedIdstring The ID of the deleted product
Get a single order by ID from your Shopify store
Inputs and outputsParameter Type Required Description lineItemsFirstnumber No Maximum lineItems in this page (default 50, max 50) lineItemsAfterstring No Cursor from lineItems.pageInfo.endCursor for the next page shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) orderIdstring Yes Order ID (gid://shopify/Order/123456789)
Parameter Type Description orderobject The order details ↳ poNumber string Purchase order number ↳ customAttributes array Order attributes ↳ key string Attribute key ↳ value string Attribute value ↳ id string Unique order identifier (GID) ↳ name string Order name (e.g., #1001) ↳ email string Customer email for the order ↳ phone string Customer phone for the order ↳ createdAt string Order creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ cancelledAt string Cancellation timestamp (ISO 8601) ↳ closedAt string Closure timestamp (ISO 8601) ↳ displayFinancialStatus string Financial status (PENDING, AUTHORIZED, PARTIALLY_PAID, PAID, PARTIALLY_REFUNDED, REFUNDED, VOIDED) ↳ displayFulfillmentStatus string Fulfillment status (UNFULFILLED, PARTIALLY_FULFILLED, FULFILLED, RESTOCKED, PENDING_FULFILLMENT, OPEN, IN_PROGRESS, ON_HOLD, SCHEDULED) ↳ totalPriceSet object Total order price ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ subtotalPriceSet object Order subtotal (before shipping and taxes) ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ totalTaxSet object Total tax amount ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ totalShippingPriceSet object Total shipping price ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ note string Order note ↳ tags array Order tags ↳ customer object Customer who placed the order ↳ id string Unique customer identifier (GID) ↳ email string Customer email address ↳ firstName string Customer first name ↳ lastName string Customer last name ↳ phone string Customer phone number ↳ lineItems object Order line items page; use Get Order with lineItemsAfter for subsequent pages ↳ pageInfo object Line item pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Array of line item edges ↳ node object Line item node ↳ id string Unique line item identifier (GID) ↳ title string Product title ↳ quantity number Quantity ordered ↳ variant object Associated product variant ↳ id string Unique variant identifier (GID) ↳ title string Variant title ↳ price string Variant price ↳ barcode string Variant barcode ↳ taxable boolean Whether the variant is taxable ↳ inventoryPolicy string Inventory policy (DENY or CONTINUE) ↳ inventoryItem object Inventory item for stock operations ↳ id string Inventory item GID ↳ sku string SKU ↳ tracked boolean Whether stock is tracked ↳ selectedOptions array Selected product options ↳ name string Option name ↳ value string Selected value ↳ compareAtPrice string Compare at price ↳ sku string Stock keeping unit ↳ inventoryQuantity number Available inventory quantity ↳ originalTotalSet object Original total price before discounts ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ discountedTotalSet object Total price after discounts ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ shippingAddress object Shipping address ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number ↳ billingAddress object Billing address ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number ↳ fulfillments array Order fulfillments ↳ id string Unique fulfillment identifier (GID) ↳ status string Fulfillment status (pending, open, success, cancelled, error, failure) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ trackingInfo array Tracking information for shipments ↳ company string Shipping carrier name ↳ number string Tracking number ↳ url string Tracking URL
List orders from your Shopify store with optional filtering
Inputs and outputsParameter Type Required Description includeDetailsboolean No Include expanded nested details; uses a smaller page limit to stay within Shopify query costs reverseboolean No Reverse the result sort order (default false) sortKeystring No Sort results by CREATED_AT, CURRENT_TOTAL_PRICE, CUSTOMER_NAME, DESTINATION, FINANCIAL_STATUS, FULFILLMENT_STATUS, ID, ORDER_NUMBER, PO_NUMBER, PROCESSED_AT, RELEVANCE, TOTAL_ITEMS_QUANTITY, TOTAL_PRICE, UPDATED_AT (default Shopify ordering) shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) afterstring No Cursor from pageInfo.endCursor to retrieve the next page firstnumber No Number of orders to return (default: 50, max: 250; with includeDetails: default/max 10) statusstring No Filter by order status (open, closed, cancelled, any) querystring No Search query to filter orders (e.g., "financial_status:paid" or "fulfillment_status:unfulfilled" or "email:customer@example.com ")
Parameter Type Description ordersarray List of orders ↳ poNumber string Purchase order number ↳ customAttributes array Order attributes ↳ key string Attribute key ↳ value string Attribute value ↳ id string Unique order identifier (GID) ↳ name string Order name (e.g., #1001) ↳ email string Customer email for the order ↳ phone string Customer phone for the order ↳ createdAt string Order creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ cancelledAt string Cancellation timestamp (ISO 8601) ↳ closedAt string Closure timestamp (ISO 8601) ↳ displayFinancialStatus string Financial status (PENDING, AUTHORIZED, PARTIALLY_PAID, PAID, PARTIALLY_REFUNDED, REFUNDED, VOIDED) ↳ displayFulfillmentStatus string Fulfillment status (UNFULFILLED, PARTIALLY_FULFILLED, FULFILLED, RESTOCKED, PENDING_FULFILLMENT, OPEN, IN_PROGRESS, ON_HOLD, SCHEDULED) ↳ totalPriceSet object Total order price ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ subtotalPriceSet object Order subtotal (before shipping and taxes) ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ totalTaxSet object Total tax amount ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ totalShippingPriceSet object Total shipping price ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ note string Order note ↳ tags array Order tags ↳ customer object Customer who placed the order ↳ id string Unique customer identifier (GID) ↳ email string Customer email address ↳ firstName string Customer first name ↳ lastName string Customer last name ↳ phone string Customer phone number ↳ lineItems object Order line items page; use Get Order with lineItemsAfter for subsequent pages ↳ pageInfo object Line item pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Array of line item edges ↳ node object Line item node ↳ id string Unique line item identifier (GID) ↳ title string Product title ↳ quantity number Quantity ordered ↳ variant object Associated product variant ↳ id string Unique variant identifier (GID) ↳ title string Variant title ↳ price string Variant price ↳ barcode string Variant barcode ↳ taxable boolean Whether the variant is taxable ↳ inventoryPolicy string Inventory policy (DENY or CONTINUE) ↳ inventoryItem object Inventory item for stock operations ↳ id string Inventory item GID ↳ sku string SKU ↳ tracked boolean Whether stock is tracked ↳ selectedOptions array Selected product options ↳ name string Option name ↳ value string Selected value ↳ compareAtPrice string Compare at price ↳ sku string Stock keeping unit ↳ inventoryQuantity number Available inventory quantity ↳ originalTotalSet object Original total price before discounts ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ discountedTotalSet object Total price after discounts ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ shippingAddress object Shipping address ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number ↳ billingAddress object Billing address ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number ↳ fulfillments array Order fulfillments ↳ id string Unique fulfillment identifier (GID) ↳ status string Fulfillment status (pending, open, success, cancelled, error, failure) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ trackingInfo array Tracking information for shipments ↳ company string Shipping carrier name ↳ number string Tracking number ↳ url string Tracking URL pageInfoobject Pagination information ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page
Update an existing order in your Shopify store (note, tags, email)
Inputs and outputsParameter Type Required Description phonestring No Customer phone number for the order shippingAddressjson No MailingAddressInput object with firstName, lastName, address1, address2, city, provinceCode, countryCode, zip, and phone customAttributesarray No Order attributes as an array of {key, value} objects metafieldsarray No MetafieldInput array: namespace, key, type, value, or id poNumberstring No Purchase order number includeDetailsboolean No Include product variants, addresses, and fulfillments; requires read_products, protected-address access, and a scope accepted by Fulfillment shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) orderIdstring Yes Order ID to update (gid://shopify/Order/123456789) notestring No New order note tagsarray No New order tags emailstring No New customer email for the order
Parameter Type Description orderobject The updated order ↳ poNumber string Purchase order number ↳ customAttributes array Order attributes ↳ key string Attribute key ↳ value string Attribute value ↳ id string Unique order identifier (GID) ↳ name string Order name (e.g., #1001) ↳ email string Customer email for the order ↳ phone string Customer phone for the order ↳ createdAt string Order creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ cancelledAt string Cancellation timestamp (ISO 8601) ↳ closedAt string Closure timestamp (ISO 8601) ↳ displayFinancialStatus string Financial status (PENDING, AUTHORIZED, PARTIALLY_PAID, PAID, PARTIALLY_REFUNDED, REFUNDED, VOIDED) ↳ displayFulfillmentStatus string Fulfillment status (UNFULFILLED, PARTIALLY_FULFILLED, FULFILLED, RESTOCKED, PENDING_FULFILLMENT, OPEN, IN_PROGRESS, ON_HOLD, SCHEDULED) ↳ totalPriceSet object Total order price ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ subtotalPriceSet object Order subtotal (before shipping and taxes) ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ totalTaxSet object Total tax amount ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ totalShippingPriceSet object Total shipping price ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ note string Order note ↳ tags array Order tags ↳ customer object Customer who placed the order ↳ id string Unique customer identifier (GID) ↳ email string Customer email address ↳ firstName string Customer first name ↳ lastName string Customer last name ↳ phone string Customer phone number ↳ lineItems object Order line items page; use Get Order with lineItemsAfter for subsequent pages ↳ pageInfo object Line item pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Array of line item edges ↳ node object Line item node ↳ id string Unique line item identifier (GID) ↳ title string Product title ↳ quantity number Quantity ordered ↳ variant object Associated product variant ↳ id string Unique variant identifier (GID) ↳ title string Variant title ↳ price string Variant price ↳ barcode string Variant barcode ↳ taxable boolean Whether the variant is taxable ↳ inventoryPolicy string Inventory policy (DENY or CONTINUE) ↳ inventoryItem object Inventory item for stock operations ↳ id string Inventory item GID ↳ sku string SKU ↳ tracked boolean Whether stock is tracked ↳ selectedOptions array Selected product options ↳ name string Option name ↳ value string Selected value ↳ compareAtPrice string Compare at price ↳ sku string Stock keeping unit ↳ inventoryQuantity number Available inventory quantity ↳ originalTotalSet object Original total price before discounts ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ discountedTotalSet object Total price after discounts ↳ shopMoney object Amount in shop currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ presentmentMoney object Amount in presentment currency ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ shippingAddress object Shipping address ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number ↳ billingAddress object Billing address ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number ↳ fulfillments array Order fulfillments ↳ id string Unique fulfillment identifier (GID) ↳ status string Fulfillment status (pending, open, success, cancelled, error, failure) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ trackingInfo array Tracking information for shipments ↳ company string Shipping carrier name ↳ number string Tracking number ↳ url string Tracking URL
Cancel an order in your Shopify store
Inputs and outputsParameter Type Required Description shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) orderIdstring Yes Order ID to cancel (gid://shopify/Order/123456789) reasonstring Yes Cancellation reason (CUSTOMER, DECLINED, FRAUD, INVENTORY, STAFF, OTHER) notifyCustomerboolean No Whether to notify the customer about the cancellation restockboolean Yes Whether to restock the inventory committed to the order refundMethodjson No Optional refund method object, for example {"originalPaymentMethodsRefund": true} staffNotestring No A note about the cancellation for staff reference
Parameter Type Description jobResultobject Cancellation outcome; pass its ID to Get Job until done, then inspect status and errors ↳ id string Cancellation result GID; pass to Get Job ↳ done boolean Whether the request has finished processing; inspect status and errors for the outcome ↳ status string Current cancellation status ↳ errors array Asynchronous cancellation errors ↳ field array Input field path ↳ message string Error message ↳ code string Cancellation error code ↳ order object Associated order ↳ id string Order GID ↳ cancelledAt string Cancellation timestamp, null until cancelled jobobject Legacy job progress; use jobResult to verify cancellation outcome ↳ id string Job ID ↳ done boolean Whether processing ran; this alone does not prove cancellation succeeded orderobject The cancellation result ↳ id string Job identifier for the cancellation ↳ cancelled boolean Whether the cancellation completed ↳ message string Status message
Create a new customer in your Shopify store
Inputs and outputsParameter Type Required Description localestring No Customer locale, such as en taxExemptboolean No Whether the customer is exempt from taxes metafieldsarray No MetafieldInput array: namespace, key, type, value, or id emailMarketingConsentjson No CustomerEmailMarketingConsentInput with marketingState, marketingOptInLevel, consentUpdatedAt smsMarketingConsentjson No CustomerSmsMarketingConsentInput with marketingState, marketingOptInLevel, consentUpdatedAt shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) emailstring No Customer email address firstNamestring No Customer first name lastNamestring No Customer last name phonestring No Customer phone number notestring No Note about the customer tagsarray No Customer tags addressesarray No Customer addresses
Parameter Type Description customerobject The created customer ↳ emailMarketingConsent object Email marketing consent ↳ marketingState string Consent state ↳ marketingOptInLevel string Opt-in level ↳ consentUpdatedAt string Consent update timestamp ↳ smsMarketingConsent object SMS marketing consent ↳ marketingState string Consent state ↳ marketingOptInLevel string Opt-in level ↳ consentUpdatedAt string Consent update timestamp ↳ id string Unique customer identifier (GID) ↳ email string Customer email address ↳ firstName string Customer first name ↳ lastName string Customer last name ↳ phone string Customer phone number ↳ createdAt string Account creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ note string Internal notes about the customer ↳ tags array Customer tags for categorization ↳ numberOfOrders string Lifetime order count as an unsigned integer string ↳ locale string Customer locale ↳ taxExempt boolean Whether the customer is tax exempt ↳ amountSpent object Total amount spent by customer ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ defaultAddress object Customer default address ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number ↳ addresses array Customer addresses ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number
Get a single customer by ID from your Shopify store
Inputs and outputsParameter Type Required Description shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) customerIdstring Yes Customer ID (gid://shopify/Customer/123456789)
Parameter Type Description customerobject The customer details ↳ emailMarketingConsent object Email marketing consent ↳ marketingState string Consent state ↳ marketingOptInLevel string Opt-in level ↳ consentUpdatedAt string Consent update timestamp ↳ smsMarketingConsent object SMS marketing consent ↳ marketingState string Consent state ↳ marketingOptInLevel string Opt-in level ↳ consentUpdatedAt string Consent update timestamp ↳ id string Unique customer identifier (GID) ↳ email string Customer email address ↳ firstName string Customer first name ↳ lastName string Customer last name ↳ phone string Customer phone number ↳ createdAt string Account creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ note string Internal notes about the customer ↳ tags array Customer tags for categorization ↳ numberOfOrders string Lifetime order count as an unsigned integer string ↳ locale string Customer locale ↳ taxExempt boolean Whether the customer is tax exempt ↳ amountSpent object Total amount spent by customer ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ defaultAddress object Customer default address ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number ↳ addresses array Customer addresses ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number
List customers from your Shopify store with optional filtering
Inputs and outputsParameter Type Required Description reverseboolean No Reverse the result sort order (default false) sortKeystring No Sort results by CREATED_AT, ID, LOCATION, NAME, RELEVANCE, UPDATED_AT (default Shopify ordering) shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) afterstring No Cursor from pageInfo.endCursor to retrieve the next page firstnumber No Number of customers to return (default: 50, max: 250) querystring No Search query to filter customers (e.g., "first_name:John" or "last_name:Smith" or "email:*@gmail.com" or "tag:vip")
Parameter Type Description customersarray List of customers ↳ emailMarketingConsent object Email marketing consent ↳ marketingState string Consent state ↳ marketingOptInLevel string Opt-in level ↳ consentUpdatedAt string Consent update timestamp ↳ smsMarketingConsent object SMS marketing consent ↳ marketingState string Consent state ↳ marketingOptInLevel string Opt-in level ↳ consentUpdatedAt string Consent update timestamp ↳ id string Unique customer identifier (GID) ↳ email string Customer email address ↳ firstName string Customer first name ↳ lastName string Customer last name ↳ phone string Customer phone number ↳ createdAt string Account creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ note string Internal notes about the customer ↳ tags array Customer tags for categorization ↳ numberOfOrders string Lifetime order count as an unsigned integer string ↳ locale string Customer locale ↳ taxExempt boolean Whether the customer is tax exempt ↳ amountSpent object Total amount spent by customer ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ defaultAddress object Customer default address ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number pageInfoobject Pagination information ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page
Update an existing customer in your Shopify store
Inputs and outputsParameter Type Required Description addressesarray No MailingAddressInput array; replacing addresses is deprecated by Shopify localestring No Customer locale, such as en taxExemptboolean No Whether the customer is exempt from taxes metafieldsarray No MetafieldInput array: namespace, key, type, value, or id emailMarketingConsentjson No CustomerEmailMarketingConsentInput with marketingState, marketingOptInLevel, consentUpdatedAt smsMarketingConsentjson No CustomerSmsMarketingConsentInput with marketingState, marketingOptInLevel, consentUpdatedAt shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) customerIdstring Yes Customer ID to update (gid://shopify/Customer/123456789) emailstring No New customer email address firstNamestring No New customer first name lastNamestring No New customer last name phonestring No New customer phone number notestring No New note about the customer tagsarray No New customer tags
Parameter Type Description customerobject The updated customer ↳ emailMarketingConsent object Email marketing consent ↳ marketingState string Consent state ↳ marketingOptInLevel string Opt-in level ↳ consentUpdatedAt string Consent update timestamp ↳ smsMarketingConsent object SMS marketing consent ↳ marketingState string Consent state ↳ marketingOptInLevel string Opt-in level ↳ consentUpdatedAt string Consent update timestamp ↳ id string Unique customer identifier (GID) ↳ email string Customer email address ↳ firstName string Customer first name ↳ lastName string Customer last name ↳ phone string Customer phone number ↳ createdAt string Account creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ note string Internal notes about the customer ↳ tags array Customer tags for categorization ↳ numberOfOrders string Lifetime order count as an unsigned integer string ↳ locale string Customer locale ↳ taxExempt boolean Whether the customer is tax exempt ↳ amountSpent object Total amount spent by customer ↳ amount string Decimal money amount ↳ currencyCode string Currency code (ISO 4217) ↳ defaultAddress object Customer default address ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number ↳ addresses array Customer addresses ↳ firstName string First name ↳ lastName string Last name ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number
Delete a customer from your Shopify store
Inputs and outputsParameter Type Required Description shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) customerIdstring Yes Customer ID to delete (gid://shopify/Customer/123456789)
Parameter Type Description deletedIdstring The ID of the deleted customer
List inventory items from your Shopify store. Use this to find inventory item IDs by SKU.
Inputs and outputsParameter Type Required Description reverseboolean No Reverse the result sort order (default false) shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) afterstring No Cursor from pageInfo.endCursor to retrieve the next page firstnumber No Number of inventory items to return (default: 50, max: 250) querystring No Search query to filter inventory items (e.g., "sku:ABC123")
Parameter Type Description inventoryItemsarray List of inventory items with their IDs, SKUs, and stock levels ↳ id string Unique inventory item identifier (GID) ↳ sku string Stock keeping unit ↳ tracked boolean Whether inventory is tracked ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ variant object Associated product variant ↳ id string Variant identifier (GID) ↳ title string Variant title ↳ product object Associated product ↳ id string Product identifier (GID) ↳ title string Product title ↳ inventoryLevelsPageInfo object Pagination for location summary; use Get Inventory Level for subsequent pages ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ inventoryLevels array Inventory levels at different locations ↳ id string Inventory level identifier (GID) ↳ available number Available quantity ↳ onHand number On-hand quantity ↳ location object Location for this inventory level ↳ id string Location identifier (GID) ↳ name string Location name pageInfoobject Pagination information ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page
Get inventory level for a product variant at a specific location
Inputs and outputsParameter Type Required Description firstnumber No Locations per page when locationId is omitted (default 50, max 250) afterstring No Cursor from inventoryLevel.pageInfo.endCursor shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) inventoryItemIdstring Yes Inventory item ID (gid://shopify/InventoryItem/123456789) locationIdstring No Location ID to filter by (optional)
Parameter Type Description inventoryLevelobject The inventory level details ↳ pageInfo object Location pagination when no locationId is supplied ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ id string Inventory item identifier (GID) ↳ sku string Stock keeping unit ↳ tracked boolean Whether inventory is tracked ↳ levels array Inventory levels at different locations ↳ id string Inventory level identifier (GID) ↳ available number Available quantity ↳ onHand number On-hand quantity ↳ committed number Committed quantity ↳ incoming number Incoming quantity ↳ reserved number Reserved quantity ↳ location object Location for this inventory level ↳ id string Location identifier (GID) ↳ name string Location name
Adjust inventory quantity for a product variant at a specific location
Inputs and outputsParameter Type Required Description idempotencyKeystring No Unique key for this adjustment; reuse the same key when retrying the same change reasonstring No Inventory reason, e.g. correction, received, damaged, or promotion (default correction) namestring No Inventory quantity to adjust: available or on_hand (default available) referenceDocumentUristring No URI identifying the source document for this adjustment changeFromQuantitynumber No Expected current quantity; prevents applying an adjustment to stale stock ledgerDocumentUristring No Ledger entry URI; required when adjusting on_hand shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) inventoryItemIdstring Yes Inventory item ID (gid://shopify/InventoryItem/123456789) locationIdstring Yes Location ID (gid://shopify/Location/123456789) deltanumber Yes Amount to adjust (positive to increase, negative to decrease)
Parameter Type Description inventoryLevelobject The inventory adjustment result ↳ adjustmentGroup object Inventory adjustment group details ↳ createdAt string Adjustment timestamp (ISO 8601) ↳ reason string Adjustment reason ↳ referenceDocumentUri string Source document URI ↳ changes array Inventory changes applied ↳ name string Quantity name (e.g., available) ↳ delta number Quantity change amount ↳ quantityAfterChange number Quantity after adjustment, when available ↳ item object Inventory item ↳ id string Inventory item identifier (GID) ↳ sku string Stock keeping unit ↳ location object Location of the adjustment ↳ id string Location identifier (GID) ↳ name string Location name
List inventory locations from your Shopify store. Use this to find location IDs needed for inventory operations.
Inputs and outputsParameter Type Required Description reverseboolean No Reverse the result sort order (default false) sortKeystring No Sort results by ID, NAME, RELEVANCE (default Shopify ordering) querystring No Shopify location search query, e.g. name:Warehouse includeLegacyboolean No Include legacy fulfillment-service locations (default false) shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) afterstring No Cursor from pageInfo.endCursor to retrieve the next page firstnumber No Number of locations to return (default: 50, max: 250) includeInactiveboolean No Whether to include deactivated locations (default: false)
Parameter Type Description locationsarray List of locations with their IDs, names, and addresses ↳ id string Unique location identifier (GID) ↳ name string Location name ↳ isActive boolean Whether the location is active ↳ fulfillsOnlineOrders boolean Whether the location fulfills online orders ↳ address object Location address ↳ address1 string Street address line 1 ↳ address2 string Street address line 2 ↳ city string City ↳ province string Province or state name ↳ provinceCode string Province or state code ↳ country string Country name ↳ countryCode string Country code (ISO 3166-1 alpha-2) ↳ zip string Postal or ZIP code ↳ phone string Phone number pageInfoobject Pagination information ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page
Create a fulfillment to mark order items as shipped. Requires a fulfillment order ID (use List Fulfillment Orders to find it).
Inputs and outputsParameter Type Required Description fulfillmentOrderLineItemsarray No Partial fulfillment items as [{id: "gid://shopify/FulfillmentOrderLineItem/123", quantity: 1}]; omit to fulfill all remaining items messagestring No Message associated with the fulfillment originAddressjson No FulfillmentOriginAddressInput with address1, address2, city, countryCode, provinceCode, zip trackingNumbersarray No Multiple tracking numbers as a JSON string array trackingUrlsarray No Multiple tracking URLs as a JSON string array shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) fulfillmentOrderIdstring Yes The fulfillment order ID (e.g., gid://shopify/FulfillmentOrder/123456789) trackingNumberstring No Tracking number for the shipment trackingCompanystring No Shipping carrier name (e.g., UPS, FedEx, USPS, DHL) trackingUrlstring No URL to track the shipment notifyCustomerboolean No Whether to send a shipping confirmation email to the customer (default: true)
Parameter Type Description fulfillmentobject The created fulfillment with tracking info and fulfilled items ↳ lineItemsPageInfo object Fulfillment item pagination; use Get Fulfillment for subsequent pages ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ id string Unique fulfillment identifier (GID) ↳ status string Fulfillment status (pending, open, success, cancelled, error, failure) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ trackingInfo array Tracking information for shipments ↳ company string Shipping carrier name ↳ number string Tracking number ↳ url string Tracking URL ↳ fulfillmentLineItems array Fulfilled line items ↳ id string Fulfillment line item identifier (GID) ↳ quantity number Quantity fulfilled ↳ lineItem object Associated order line item ↳ title string Product title
List product collections from your Shopify store. Filter by title, type (custom/smart), or handle.
Inputs and outputsParameter Type Required Description reverseboolean No Reverse the result sort order (default false) sortKeystring No Sort results by ID, RELEVANCE, TITLE, UPDATED_AT (default Shopify ordering) shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) afterstring No Cursor from pageInfo.endCursor to retrieve the next page firstnumber No Number of collections to return (default: 50, max: 250) querystring No Search query to filter collections (e.g., "title:Summer" or "collection_type:smart")
Parameter Type Description collectionsarray List of collections with their IDs, titles, and product counts ↳ id string Unique collection identifier (GID) ↳ title string Collection title ↳ handle string URL-friendly collection identifier ↳ description string Plain text description ↳ descriptionHtml string HTML-formatted description ↳ productsCount number Number of products in the collection ↳ sortOrder string Product sort order in the collection ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ image object Collection image ↳ id string Unique image identifier (GID) ↳ url string Image URL ↳ altText string Alternative text for accessibility pageInfoobject Pagination information ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page
Find fulfillment order IDs and remaining items for an order at merchant-managed locations
Inputs and outputsParameter Type Required Description shopDomainstring No Shop domain supplied by the connected credential (store.myshopify.com) orderIdstring Yes Order GID to retrieve fulfillment orders for firstnumber No Results per page (default 20, max 20) afterstring No Cursor from pageInfo.endCursor to continue
Parameter Type Description fulfillmentOrdersarray Fulfillment orders visible to the connected app ↳ id string Fulfillment order GID to pass to Create Fulfillment ↳ orderId string Associated order GID ↳ status string Fulfillment order status ↳ requestStatus string Fulfillment request status ↳ createdAt string Creation timestamp ↳ updatedAt string Last update timestamp ↳ fulfillAt string Earliest fulfillment timestamp ↳ fulfillBy string Fulfillment deadline ↳ assignedLocation object Assigned fulfillment location ↳ name string Assigned location name ↳ location object Current location ↳ id string Location GID ↳ name string Location name ↳ supportedActions array Actions permitted for this fulfillment order ↳ action string Permitted action ↳ externalUrl string External fulfillment URL when applicable ↳ lineItems object Fulfillment order item page; use Get Fulfillment Order to continue ↳ pageInfo object Line item pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Fulfillment order item edges ↳ node object Fulfillment order line item ↳ id string Fulfillment order line item GID for partial fulfillment ↳ totalQuantity number Total quantity assigned ↳ remainingQuantity number Quantity still to fulfill ↳ inventoryItemId string Inventory item GID ↳ productTitle string Product title ↳ variantTitle string Variant title ↳ sku string SKU ↳ lineItem object Original order line item ↳ id string Order line item GID pageInfoobject Fulfillment order pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page
Read a fulfillment order and one page of line items for partial fulfillment
Inputs and outputsParameter Type Required Description shopDomainstring No Shop domain supplied by the connected credential (store.myshopify.com) fulfillmentOrderIdstring Yes Fulfillment order GID firstnumber No Results per page (default 50, max 250) afterstring No Cursor from pageInfo.endCursor to continue
Parameter Type Description fulfillmentOrderobject Fulfillment order with remaining quantities and item pagination ↳ id string Fulfillment order GID to pass to Create Fulfillment ↳ orderId string Associated order GID ↳ status string Fulfillment order status ↳ requestStatus string Fulfillment request status ↳ createdAt string Creation timestamp ↳ updatedAt string Last update timestamp ↳ fulfillAt string Earliest fulfillment timestamp ↳ fulfillBy string Fulfillment deadline ↳ assignedLocation object Assigned fulfillment location ↳ name string Assigned location name ↳ location object Current location ↳ id string Location GID ↳ name string Location name ↳ supportedActions array Actions permitted for this fulfillment order ↳ action string Permitted action ↳ externalUrl string External fulfillment URL when applicable ↳ lineItems object Fulfillment order item page; use Get Fulfillment Order to continue ↳ pageInfo object Line item pagination ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ edges array Fulfillment order item edges ↳ node object Fulfillment order line item ↳ id string Fulfillment order line item GID for partial fulfillment ↳ totalQuantity number Total quantity assigned ↳ remainingQuantity number Quantity still to fulfill ↳ inventoryItemId string Inventory item GID ↳ productTitle string Product title ↳ variantTitle string Variant title ↳ sku string SKU ↳ lineItem object Original order line item ↳ id string Order line item GID
Read Shopify job progress or the outcome and errors of an order cancellation
Inputs and outputsParameter Type Required Description shopDomainstring No Shop domain supplied by the connected credential (store.myshopify.com) jobIdstring Yes jobResult.id (OrderCancelJobResult GID) for cancellation outcome, or a legacy Job GID
Parameter Type Description jobResultobject Cancellation outcome when using an OrderCancelJobResult ID ↳ id string Cancellation result GID; pass to Get Job ↳ done boolean Whether the request has finished processing; inspect status and errors for the outcome ↳ status string Current cancellation status ↳ errors array Asynchronous cancellation errors ↳ field array Input field path ↳ message string Error message ↳ code string Cancellation error code ↳ order object Associated order ↳ id string Order GID ↳ cancelledAt string Cancellation timestamp, null until cancelled jobobject Asynchronous job status ↳ id string Job GID ↳ done boolean Whether processing ran; inspect cancellation result for success
Create product variants with pricing, options, inventory attributes, and metafields
Inputs and outputsParameter Type Required Description shopDomainstring No Shop domain supplied by the connected credential (store.myshopify.com) productIdstring Yes Product GID variantsarray Yes ProductVariantsBulkInput array (1-250): optionValues for creation, price, compareAtPrice, inventoryItem, taxable, inventoryPolicy, metafields strategystring No DEFAULT, REMOVE_STANDALONE_VARIANT, or PRESERVE_STANDALONE_VARIANT mediaarray No CreateMediaInput array with originalSource, mediaContentType, and alt
Parameter Type Description productVariantsarray Variants successfully created or updated ↳ id string Unique variant identifier (GID) ↳ title string Variant title ↳ price string Variant price ↳ barcode string Variant barcode ↳ taxable boolean Whether the variant is taxable ↳ inventoryPolicy string Inventory policy (DENY or CONTINUE) ↳ inventoryItem object Inventory item for stock operations ↳ id string Inventory item GID ↳ sku string SKU ↳ tracked boolean Whether stock is tracked ↳ selectedOptions array Selected product options ↳ name string Option name ↳ value string Selected value ↳ compareAtPrice string Compare at price ↳ sku string Stock keeping unit ↳ inventoryQuantity number Available inventory quantity userErrorsarray Validation errors, including partial update failures ↳ field array Input field path ↳ message string Validation error
Update product variants with pricing, options, inventory attributes, and metafields
Inputs and outputsParameter Type Required Description shopDomainstring No Shop domain supplied by the connected credential (store.myshopify.com) productIdstring Yes Product GID variantsarray Yes ProductVariantsBulkInput array (1-250): id for updates, price, compareAtPrice, inventoryItem, optionValues, taxable, inventoryPolicy, metafields allowPartialUpdatesboolean No Allow valid variants to update even if other variants fail mediaarray No CreateMediaInput array with originalSource, mediaContentType, and alt
Parameter Type Description productVariantsarray Variants successfully created or updated ↳ id string Unique variant identifier (GID) ↳ title string Variant title ↳ price string Variant price ↳ barcode string Variant barcode ↳ taxable boolean Whether the variant is taxable ↳ inventoryPolicy string Inventory policy (DENY or CONTINUE) ↳ inventoryItem object Inventory item for stock operations ↳ id string Inventory item GID ↳ sku string SKU ↳ tracked boolean Whether stock is tracked ↳ selectedOptions array Selected product options ↳ name string Option name ↳ value string Selected value ↳ compareAtPrice string Compare at price ↳ sku string Stock keeping unit ↳ inventoryQuantity number Available inventory quantity userErrorsarray Validation errors, including partial update failures ↳ field array Input field path ↳ message string Validation error
Read shipment tracking and one page of fulfilled line items
Inputs and outputsParameter Type Required Description shopDomainstring No Shop domain supplied by the connected credential (store.myshopify.com) fulfillmentIdstring Yes Fulfillment GID firstnumber No Results per page (default 50, max 250) afterstring No Cursor from pageInfo.endCursor to continue
Parameter Type Description fulfillmentobject Shipment tracking and line item page ↳ lineItemsPageInfo object Fulfillment item pagination; use Get Fulfillment for subsequent pages ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ id string Unique fulfillment identifier (GID) ↳ status string Fulfillment status (pending, open, success, cancelled, error, failure) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ trackingInfo array Tracking information for shipments ↳ company string Shipping carrier name ↳ number string Tracking number ↳ url string Tracking URL ↳ fulfillmentLineItems array Fulfilled line items ↳ id string Fulfillment line item identifier (GID) ↳ quantity number Quantity fulfilled ↳ lineItem object Associated order line item ↳ title string Product title
Update tracking numbers, URLs, or carrier for an existing fulfillment
Inputs and outputsParameter Type Required Description shopDomainstring No Shop domain supplied by the connected credential (store.myshopify.com) fulfillmentIdstring Yes Fulfillment GID trackingInfojson Yes FulfillmentTrackingInput object: company, number, url, or numbers and urls arrays notifyCustomerboolean No Send the customer an updated shipment notification
Parameter Type Description fulfillmentobject Updated shipment tracking and line item page ↳ lineItemsPageInfo object Fulfillment item pagination; use Get Fulfillment for subsequent pages ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ id string Unique fulfillment identifier (GID) ↳ status string Fulfillment status (pending, open, success, cancelled, error, failure) ↳ createdAt string Creation timestamp (ISO 8601) ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ trackingInfo array Tracking information for shipments ↳ company string Shipping carrier name ↳ number string Tracking number ↳ url string Tracking URL ↳ fulfillmentLineItems array Fulfilled line items ↳ id string Fulfillment line item identifier (GID) ↳ quantity number Quantity fulfilled ↳ lineItem object Associated order line item ↳ title string Product title
Get a specific collection by ID, including its products. Use this to retrieve products within a collection.
Inputs and outputsParameter Type Required Description productsAfterstring No Cursor from products.pageInfo.endCursor for the next page shopDomainstring No Your Shopify store domain (e.g., mystore.myshopify.com) collectionIdstring Yes The collection ID (e.g., gid://shopify/Collection/123456789) productsFirstnumber No Number of products to return from this collection (default: 50, max: 250)
Parameter Type Description collectionobject The collection details including its products ↳ id string Unique collection identifier (GID) ↳ title string Collection title ↳ handle string URL-friendly collection identifier ↳ description string Plain text description ↳ descriptionHtml string HTML-formatted description ↳ productsCount number Number of products in the collection ↳ sortOrder string Product sort order in the collection ↳ updatedAt string Last modification timestamp (ISO 8601) ↳ image object Collection image ↳ id string Unique image identifier (GID) ↳ url string Image URL ↳ altText string Alternative text for accessibility ↳ productsPageInfo object Pagination for collection products; use productsAfter ↳ startCursor string Cursor at the start of this page ↳ endCursor string Cursor to pass as after for the next page ↳ hasNextPage boolean Whether there are more results after this page ↳ hasPreviousPage boolean Whether there are results before this page ↳ products array Products in the collection ↳ id string Unique product identifier (GID) ↳ title string Product title ↳ handle string URL-friendly product identifier ↳ status string Product status (ACTIVE, DRAFT, ARCHIVED, UNLISTED) ↳ vendor string Product vendor ↳ productType string Product type classification ↳ totalInventory number Total inventory across all variants ↳ featuredImage object Featured product image ↳ url string Featured image URL ↳ altText string Alternative text for accessibility