Shopify

Get any collection by ID (custom or smart). Args: - collectionId: Collection ID - format: Response format Returns: The collection details.

Re-open a closed order. Args: - orderId: Order ID to open Returns: The re-opened order.

Delete a discount code. Args: - priceRuleId: Price rule ID - discountCodeId: Discount code ID to delete Returns: Confirmation of deletion.

Get a single fulfillment order by ID. Args: - fulfillmentOrderId: Fulfillment order ID - format: Response format Returns: The fulfillment order details.

Update an existing smart collection. Args: - collectionId: Collection ID to update - title: New title - rules: New rules array - disjunctive: New disjunctive setting - bodyHtml: New description - handle: New handle - published: New published state - sortOrder: New sort order Returns: The updated smart collection.

Delete a smart collection. Args: - collectionId: Collection ID to delete Returns: Confirmation of deletion.

List custom collections with pagination and filters. Custom collections are manually curated product groups. Args: - limit: Number of collections to return (1-250, default: 50) - sinceId: Return collections after this ID - title: Filter by title - productId: Filter by product - handle: Filter by handle - publishedStatus: Filter by published status - format: Response format Returns: Paginated list of custom collections.

Get a single custom collection by ID. Args: - collectionId: Collection ID - format: Response format Returns: The custom collection details.

Create a new custom collection. Args: - title: Collection title (required) - bodyHtml: Description HTML - handle: URL handle - published: Whether to publish - sortOrder: Sort order (alpha-asc, alpha-desc, best-selling, created, created-desc, manual, price-asc, price-desc) - image: Image object with src or attachment Returns: The created collection.

Update an existing custom collection. Args: - collectionId: Collection ID to update - title: New title - bodyHtml: New description - handle: New handle - published: New published state - sortOrder: New sort order Returns: The updated collection.

Delete a custom collection. Args: - collectionId: Collection ID to delete Returns: Confirmation of deletion.

List smart collections with pagination and filters. Smart collections automatically include products based on rules. Args: - limit: Number of collections to return (1-250, default: 50) - sinceId: Return collections after this ID - title: Filter by title - productId: Filter by product - handle: Filter by handle - publishedStatus: Filter by published status - format: Response format Returns: Paginated list of smart collections.

Get a single smart collection by ID. Args: - collectionId: Collection ID - format: Response format Returns: The smart collection with its rules.

Create a new smart collection with automated rules. Args: - title: Collection title (required) - rules: Array of rule objects (required) - column: Field to match (title, type, vendor, variant_price, tag, etc.) - relation: Comparison (equals, not_equals, greater_than, less_than, starts_with, ends_with, contains) - condition: Value to match - disjunctive: If true, products match ANY rule; if false, products must match ALL rules - bodyHtml: Description HTML - handle: URL handle - published: Whether to publish - sortOrder: Sort order Returns: The created smart collection.

List products in a collection. Args: - collectionId: Collection ID - limit: Number of products to return - format: Response format Returns: Paginated list of products in the collection.

List product-collection relationships (collects). Collects link products to custom collections. Args: - limit: Number of collects to return - productId: Filter by product ID - collectionId: Filter by collection ID - format: Response format Returns: List of collect relationships.

Add a product to a custom collection. Args: - productId: Product ID to add - collectionId: Collection ID to add to - position: Position in collection (optional) Returns: The created collect relationship.

Remove a product from a custom collection. Args: - collectId: Collect ID to delete Returns: Confirmation of deletion.

List customers from the store with pagination and filters. Args: - limit: Number of customers to return (1-250, default: 50) - sinceId: Return customers after this ID - ids: Comma-separated list of customer IDs - createdAtMin: Minimum created date (ISO 8601) - createdAtMax: Maximum created date (ISO 8601) - updatedAtMin: Minimum updated date - updatedAtMax: Maximum updated date - format: Response format Returns: Paginated list of customers.

Get a single customer by ID. Args: - customerId: The customer ID - format: Response format Returns: The customer with all details including addresses.

Create a new customer. Args: - email: Customer email (required) - firstName: First name - lastName: Last name - phone: Phone number (E.164 format) - note: Customer note - tags: Comma-separated tags - acceptsMarketing: Marketing consent - addresses: Array of address objects - sendEmailWelcome: Send welcome email - sendEmailInvite: Send account invite email Returns: The created customer.

Update an existing customer. Args: - customerId: Customer ID to update - email: New email - firstName: New first name - lastName: New last name - phone: New phone - note: New note - tags: New tags - acceptsMarketing: New marketing consent Returns: The updated customer.

Delete a customer. Note: Customers with orders cannot be deleted. Args: - customerId: Customer ID to delete Returns: Confirmation of deletion.

Get the count of customers matching filters. Args: - createdAtMin: Minimum created date - createdAtMax: Maximum created date - updatedAtMin: Minimum updated date - updatedAtMax: Maximum updated date Returns: Count of matching customers.

List all inventory locations. Locations are places where you store inventory (warehouses, retail stores, etc.). Args: - limit: Number of locations to return - format: Response format Returns: List of inventory locations.

Search for customers by query string. The query can search across multiple fields like email, name, etc. Args: - query: Search query (required) - limit: Number of results to return - order: Sort order (e.g., "last_order_date DESC") - format: Response format Returns: Matching customers.

Get orders for a specific customer. Args: - customerId: Customer ID - limit: Number of orders to return - status: Order status filter (any, open, closed, cancelled) - format: Response format Returns: Customer's orders.

List price rules with pagination and filters. Price rules define discount logic (percentage off, fixed amount, buy X get Y, etc.). Args: - limit: Number of price rules to return (1-250, default: 50) - sinceId: Return price rules after this ID - startsAt: Filter by start date - endsAt: Filter by end date - format: Response format Returns: Paginated list of price rules.

Get a single price rule by ID. Args: - priceRuleId: Price rule ID - format: Response format Returns: The price rule details.

Create a new price rule. Args: - title: Price rule title (required) - targetType: What the rule applies to (line_item, shipping_line) - targetSelection: Which items to apply to (all, entitled) - allocationMethod: How to apply discount (across, each) - valueType: Type of discount (fixed_amount, percentage) - value: Discount value (negative for discounts, e.g., "-10.00" or "-10") - customerSelection: Who can use (all, prerequisite) - startsAt: Start date (ISO 8601) - endsAt: End date (ISO 8601, optional) - oncePerCustomer: Limit to one use per customer - usageLimit: Total usage limit - prerequisiteSubtotalRange: Minimum subtotal requirement - prerequisiteQuantityRange: Minimum quantity requirement - prerequisiteToEntitlementQuantityRatio: Buy X get Y ratio - entitledProductIds: Product IDs the discount applies to - entitledVariantIds: Variant IDs the discount applies to - entitledCollectionIds: Collection IDs the discount applies to - entitledCountryIds: Country IDs for shipping discounts - prerequisiteProductIds: Required product IDs - prerequisiteVariantIds: Required variant IDs - prerequisiteCollectionIds: Required collection IDs - prerequisiteCustomerIds: Required customer IDs Returns: The created price rule.

Update an existing price rule. Args: - priceRuleId: Price rule ID to update - title: New title - value: New discount value - startsAt: New start date - endsAt: New end date - usageLimit: New usage limit - oncePerCustomer: New once per customer setting Returns: The updated price rule.

Delete a price rule and all associated discount codes. Args: - priceRuleId: Price rule ID to delete Returns: Confirmation of deletion.

List discount codes for a price rule. Discount codes are the actual codes customers enter at checkout. Args: - priceRuleId: Price rule ID - format: Response format Returns: List of discount codes.

Get a single discount code by ID. Args: - priceRuleId: Price rule ID - discountCodeId: Discount code ID - format: Response format Returns: The discount code details.

Create a discount code for a price rule. Args: - priceRuleId: Price rule ID - code: The discount code string (required, e.g., "SAVE10") Returns: The created discount code.

Update a discount code. Args: - priceRuleId: Price rule ID - discountCodeId: Discount code ID - code: New discount code string Returns: The updated discount code.

Get a single location by ID. Args: - locationId: Location ID - format: Response format Returns: The location details.

List draft orders with pagination and filters. Draft orders are orders that haven't been completed yet. Args: - limit: Number of draft orders to return (1-250, default: 50) - sinceId: Return draft orders after this ID - status: Filter by status (open, invoice_sent, completed) - updatedAtMin: Minimum updated date - updatedAtMax: Maximum updated date - format: Response format Returns: Paginated list of draft orders.

Get a single draft order by ID. Args: - draftOrderId: Draft order ID - format: Response format Returns: The draft order with all details.

Create a new draft order. Args: - lineItems: Array of line items (required) - variantId: Product variant ID - title: Custom line item title - quantity: Quantity - price: Price per item - customer: Customer object (id or email) - email: Customer email - shippingAddress: Shipping address object - billingAddress: Billing address object - note: Order note - tags: Comma-separated tags - useCustomerDefaultAddress: Use customer's default address - taxExempt: Whether order is tax exempt - appliedDiscount: Discount to apply - title: Discount title - value: Discount value - valueType: Type (fixed_amount or percentage) Returns: The created draft order.

Update an existing draft order. Args: - draftOrderId: Draft order ID - lineItems: New line items array - customer: New customer - email: New email - shippingAddress: New shipping address - billingAddress: New billing address - note: New note - tags: New tags - appliedDiscount: New discount Returns: The updated draft order.

Delete a draft order. Args: - draftOrderId: Draft order ID to delete Returns: Confirmation of deletion.

Complete a draft order and convert it to a real order. Args: - draftOrderId: Draft order ID to complete - paymentPending: If true, marks payment as pending (default: false) Returns: The completed draft order with the created order ID.

Send an invoice for a draft order to the customer. Args: - draftOrderId: Draft order ID - to: Recipient email (optional, defaults to customer email) - from: Sender email (optional, defaults to shop email) - subject: Email subject (optional) - customMessage: Custom message to include (optional) Returns: The invoice details.

List fulfillments for an order. Args: - orderId: Order ID - limit: Number of fulfillments to return - format: Response format Returns: List of fulfillments with tracking information.

Get a single fulfillment by ID. Args: - orderId: Order ID - fulfillmentId: Fulfillment ID - format: Response format Returns: The fulfillment details.

Create a fulfillment for fulfillment orders. This uses the new Fulfillment Orders API. Args: - lineItemsByFulfillmentOrder: Array of fulfillment order line items - fulfillmentOrderId: Fulfillment order ID - fulfillmentOrderLineItems: Array of { id, quantity } - trackingInfo: Tracking information object - number: Tracking number - url: Tracking URL - company: Shipping company - notifyCustomer: Whether to send shipping notification Returns: The created fulfillment.

Update tracking information for a fulfillment. Args: - fulfillmentId: Fulfillment ID - trackingInfo: New tracking information - number: Tracking number - url: Tracking URL - company: Shipping company - notifyCustomer: Whether to notify customer of update Returns: The updated fulfillment.

Cancel a fulfillment. Args: - fulfillmentId: Fulfillment ID to cancel Returns: The cancelled fulfillment.

List fulfillment orders for an order. Fulfillment orders represent groups of items to be fulfilled together. Args: - orderId: Order ID - format: Response format Returns: List of fulfillment orders with their line items.

Get the count of locations. Returns: Count of locations.

List inventory levels for items at locations. You must provide at least one of: locationIds or inventoryItemIds. Args: - locationIds: Comma-separated location IDs - inventoryItemIds: Comma-separated inventory item IDs - limit: Number of levels to return Returns: List of inventory levels with available quantities.

Adjust the inventory level by a relative amount. Use this to increment or decrement inventory (e.g., +5 or -3). Args: - inventoryItemId: Inventory item ID - locationId: Location ID - adjustment: Amount to adjust (positive or negative) Returns: The updated inventory level.

Set the inventory level to an absolute value. Use this to set inventory to a specific number (e.g., set to 100). Args: - inventoryItemId: Inventory item ID - locationId: Location ID - available: New available quantity Returns: The updated inventory level.

Get an inventory item by ID. Inventory items are connected to product variants. Args: - inventoryItemId: Inventory item ID - format: Response format Returns: The inventory item details including SKU, cost, tracking settings.

Update an inventory item. Args: - inventoryItemId: Inventory item ID - sku: New SKU - cost: New cost - tracked: Whether to track inventory - countryCodeOfOrigin: Country of origin (ISO 3166-1 alpha-2) - provinceCodeOfOrigin: Province of origin - harmonizedSystemCode: HS tariff code Returns: The updated inventory item.

List metafields for a resource. Metafields store custom data for products, customers, orders, etc. Args: - ownerResource: Resource type (products, customers, orders, collections, etc.) - ownerId: Resource ID - limit: Number of metafields to return - namespace: Filter by namespace - key: Filter by key - format: Response format Returns: Paginated list of metafields.

Get a single metafield by ID. Args: - ownerResource: Resource type - ownerId: Resource ID - metafieldId: Metafield ID - format: Response format Returns: The metafield details.

Create a metafield for a resource. Common types: - single_line_text_field, multi_line_text_field - number_integer, number_decimal - boolean - json - date, date_time - color, url, rating - dimension, weight, volume - product_reference, variant_reference, collection_reference - file_reference Args: - ownerResource: Resource type (products, customers, orders, etc.) - ownerId: Resource ID - namespace: Metafield namespace (required) - key: Metafield key (required) - value: Metafield value (required) - type: Metafield type (required) - description: Description Returns: The created metafield.

Get a single asset from a theme. Returns the asset content (value) and metadata. Args: - themeId: Theme ID - key: Asset key (file path, e.g., "templates/index.liquid") - format: Response format Returns: The asset with its content.

Update an existing metafield. Args: - ownerResource: Resource type - ownerId: Resource ID - metafieldId: Metafield ID - value: New value - type: New type (optional) Returns: The updated metafield.

Delete a metafield. Args: - ownerResource: Resource type - ownerId: Resource ID - metafieldId: Metafield ID to delete Returns: Confirmation of deletion.

List metafields attached to the shop itself. Args: - limit: Number of metafields to return - namespace: Filter by namespace - key: Filter by key - format: Response format Returns: Paginated list of shop metafields.

Create a metafield for the shop. Args: - namespace: Metafield namespace (required) - key: Metafield key (required) - value: Metafield value (required) - type: Metafield type (required) - description: Description Returns: The created shop metafield.

List orders from the store with pagination and filters. Args: - limit: Number of orders to return (1-250, default: 50) - sinceId: Return orders after this ID - status: Order status (open, closed, cancelled, any) - financialStatus: Financial status (authorized, pending, paid, partially_paid, refunded, voided, partially_refunded, any, unpaid) - fulfillmentStatus: Fulfillment status (shipped, partial, unshipped, any, unfulfilled) - createdAtMin: Minimum created date (ISO 8601) - createdAtMax: Maximum created date (ISO 8601) - updatedAtMin: Minimum updated date - updatedAtMax: Maximum updated date - processedAtMin: Minimum processed date - processedAtMax: Maximum processed date - ids: Comma-separated list of order IDs - format: Response format Returns: Paginated list of orders.

Get a single order by ID. Args: - orderId: The order ID - format: Response format Returns: The order with all details including line items, shipping, etc.

Create a new order (typically for importing historical orders). Args: - lineItems: Array of line items (required) - variantId: Variant ID - title: Product title - quantity: Quantity - price: Price - customer: Customer object (id or email) - billingAddress: Billing address object - shippingAddress: Shipping address object - email: Customer email - financialStatus: Financial status - fulfillmentStatus: Fulfillment status - note: Order note - tags: Comma-separated tags - sendReceipt: Whether to send receipt email - sendFulfillmentReceipt: Whether to send fulfillment email Returns: The created order.

Update an existing order. Args: - orderId: Order ID to update - email: New email - phone: New phone - note: New note - tags: New tags - shippingAddress: New shipping address - buyer_accepts_marketing: Marketing consent Returns: The updated order.

Delete an order (moves to trash, can be restored within 60 days). Args: - orderId: Order ID to delete Returns: Confirmation of deletion.

Get the count of orders matching filters. Args: - status: Order status filter - financialStatus: Financial status filter - fulfillmentStatus: Fulfillment status filter - createdAtMin: Minimum created date - createdAtMax: Maximum created date Returns: Count of matching orders.

Close an order (marks as archived). Args: - orderId: Order ID to close Returns: The closed order.

Cancel an order. Args: - orderId: Order ID to cancel - reason: Cancellation reason (customer, fraud, inventory, declined, other) - email: Send cancellation email to customer - restock: Restock inventory Returns: The cancelled order.

List products from the Shopify store with pagination and filters. Args: - limit: Number of products to return (1-250, default: 50) - sinceId: Return products after this ID - title: Filter by title - vendor: Filter by vendor - handle: Filter by handle - productType: Filter by product type - collectionId: Filter by collection - status: Filter by status (active, archived, draft) - publishedStatus: Filter by published status - format: Response format ('json' or 'markdown') Returns: Paginated list of products with variants.

Get a single product by ID. Args: - productId: The product ID - format: Response format ('json' or 'markdown') Returns: The product with all variants and images.

Create a new product in the store. Args: - title: Product title (required) - bodyHtml: Product description in HTML - vendor: Product vendor - productType: Product type - tags: Comma-separated tags - status: Product status (active, archived, draft) - variants: Array of variant objects with price, sku, etc. - options: Array of option objects (name, values) - images: Array of image objects (src, alt) Returns: The created product.

Update an existing product. Args: - productId: Product ID to update - title: New product title - bodyHtml: New product description - vendor: New vendor - productType: New product type - tags: New comma-separated tags - status: New status Returns: The updated product.

Delete a product from the store. Args: - productId: Product ID to delete Returns: Confirmation of deletion.

Get the count of products matching filters. Args: - vendor: Filter by vendor - productType: Filter by product type - collectionId: Filter by collection - status: Filter by status Returns: Count of matching products.

List all variants for a product. Args: - productId: Product ID - limit: Number of variants to return - format: Response format Returns: List of product variants.

Get a single product variant by ID. Args: - variantId: Variant ID - format: Response format Returns: The variant details.

Create a new variant for a product. Args: - productId: Product ID - price: Variant price - sku: SKU code - option1: First option value - option2: Second option value - option3: Third option value - barcode: Barcode - weight: Weight - weightUnit: Weight unit (g, kg, lb, oz) - inventoryQuantity: Initial inventory quantity Returns: The created variant.

Update an existing variant. Args: - variantId: Variant ID to update - price: New price - sku: New SKU - option1/2/3: New option values - barcode: New barcode - weight: New weight - compareAtPrice: Compare at price Returns: The updated variant.

Delete a product variant. Args: - productId: Product ID - variantId: Variant ID to delete Returns: Confirmation of deletion.

List all images for a product. Args: - productId: Product ID - limit: Number of images to return - format: Response format Returns: List of product images.

Create a new image for a product. Args: - productId: Product ID - src: Image URL (required unless using attachment) - attachment: Base64-encoded image data - alt: Alt text for the image - position: Position in the image list - variantIds: Array of variant IDs to associate Returns: The created image.

Update an existing product image. Args: - productId: Product ID - imageId: Image ID - alt: New alt text - position: New position - variantIds: New variant IDs to associate Returns: The updated image.

Delete a product image. Args: - productId: Product ID - imageId: Image ID to delete Returns: Confirmation of deletion.

Test the connection to the Shopify store. Verifies that the API credentials are valid and returns shop information. Returns: Connection status and shop name if successful.

Get shop details and configuration. Returns comprehensive information about the Shopify store including: - Shop name, email, and owner info - Address and timezone - Currency and money format settings - Plan information - Feature flags Args: - format: Response format ('json' or 'markdown') Returns: Complete shop configuration object.

List all themes in the store. Returns themes with their roles (main, unpublished, demo). Args: - format: Response format Returns: List of themes.

Get a single theme by ID. Args: - themeId: Theme ID - format: Response format Returns: The theme details.

Create a new theme. Args: - name: Theme name (required) - src: URL to a ZIP file containing the theme (optional) - role: Theme role (main, unpublished) Returns: The created theme.

Update an existing theme. Args: - themeId: Theme ID to update - name: New theme name - role: New theme role (main to publish, unpublished to unpublish) Returns: The updated theme.

Delete a theme. Note: The main (published) theme cannot be deleted. Args: - themeId: Theme ID to delete Returns: Confirmation of deletion.

List all assets in a theme. Returns a list of asset keys (file paths) in the theme. Args: - themeId: Theme ID - format: Response format Returns: List of asset keys.

Create or update a theme asset. Use value for text content or attachment for binary content. Args: - themeId: Theme ID - key: Asset key (file path, e.g., "templates/custom.liquid") - value: Asset content as text - attachment: Asset content as base64-encoded string - sourceKey: Copy from another asset key (instead of value/attachment) Returns: The created/updated asset.

Delete an asset from a theme. Args: - themeId: Theme ID - key: Asset key to delete Returns: Confirmation of deletion.

List all transactions for an order. Transactions represent payments, refunds, and other monetary operations. Args: - orderId: Order ID - format: Response format Returns: List of transactions.

Get a single transaction by ID. Args: - orderId: Order ID - transactionId: Transaction ID - format: Response format Returns: The transaction details.

Create a transaction for an order. Use this to capture authorized payments or record external payments. Args: - orderId: Order ID - kind: Transaction kind (authorization, capture, sale, void, refund) - amount: Transaction amount - currency: Currency code (optional) - parentId: Parent transaction ID (for captures/refunds) - gateway: Payment gateway used Returns: The created transaction.

List all refunds for an order. Args: - orderId: Order ID - format: Response format Returns: List of refunds with line items and amounts.

Get a single refund by ID. Args: - orderId: Order ID - refundId: Refund ID - format: Response format Returns: The refund details.

Calculate the refund amounts before creating a refund. Use this to preview what a refund would look like. Args: - orderId: Order ID - refundLineItems: Array of line items to refund - lineItemId: Line item ID - quantity: Quantity to refund - restockType: How to handle inventory (no_restock, cancel, return) - shipping: Shipping refund object - fullRefund: Whether to fully refund shipping - amount: Specific amount to refund Returns: Calculated refund amounts.

Create a refund for an order. Args: - orderId: Order ID - refundLineItems: Array of line items to refund - lineItemId: Line item ID - quantity: Quantity to refund - restockType: How to handle inventory (no_restock, cancel, return) - shipping: Shipping refund object - fullRefund: Whether to fully refund shipping - amount: Specific amount to refund - notify: Whether to send refund notification to customer - note: Refund note - transactions: Refund transaction details - parentId: Parent transaction ID - amount: Amount to refund - kind: Transaction kind (usually 'refund') - gateway: Payment gateway Returns: The created refund.

List webhooks with pagination and filters. Webhooks send notifications to your app when events occur in the store. Args: - limit: Number of webhooks to return (1-250, default: 50) - sinceId: Return webhooks after this ID - topic: Filter by topic (e.g., orders/create) - address: Filter by endpoint URL - format: Response format Returns: Paginated list of webhooks.

Get a single webhook by ID. Args: - webhookId: Webhook ID - format: Response format Returns: The webhook details.

Create a new webhook subscription. Common topics: - orders/create, orders/updated, orders/paid, orders/cancelled, orders/fulfilled - products/create, products/update, products/delete - customers/create, customers/update, customers/delete - inventory_levels/update, inventory_levels/connect, inventory_levels/disconnect - fulfillments/create, fulfillments/update - carts/create, carts/update - checkouts/create, checkouts/update - app/uninstalled, shop/update Args: - topic: Event topic (required, e.g., "orders/create") - address: Callback URL (required, must be HTTPS) - format: Payload format (json or xml) - fields: Specific fields to include in payload - metafieldNamespaces: Metafield namespaces to include Returns: The created webhook.

Update an existing webhook. Args: - webhookId: Webhook ID to update - address: New callback URL - topic: New topic - format: New payload format - fields: New fields to include - metafieldNamespaces: New metafield namespaces Returns: The updated webhook.

Delete a webhook subscription. Args: - webhookId: Webhook ID to delete Returns: Confirmation of deletion.

Get the count of webhooks matching filters. Args: - topic: Filter by topic - address: Filter by address Returns: Count of matching webhooks.