Skip to main content

Shopify

Connects to the Shopify Admin API for managing an online store. An agent can list and inspect products, orders, and customers, and create new products.

Add to an agent node's tools array with _node_type: "tool-shopify". See Connector Reference — How connectors are used.

Authentication

FieldRequiredDescription
shop_domainYesShopify store domain (e.g. mystore.myshopify.com). Used as the base host for the Admin API.
access_tokenYesShopify Admin API access token, sent as the X-Shopify-Access-Token header. Typically a stored secret.
{
"name": "shopify",
"_node_type": "tool-shopify",
"shop_domain": "mystore.myshopify.com",
"access_token": "{{ secret.SHOPIFY_ACCESS_TOKEN }}"
}

Tools

shopify_list_products

List products from your Shopify store.

Parameters

ParameterTypeRequiredDescription
limitnumberNoMax products to return (default 10)
statusstringNoFilter by status: active, draft, archived (default active)

Returns: A list of - **<title>** by <vendor> (<product type>) id: <id> lines, or "No products found.".

shopify_get_product

Get detailed information about a Shopify product including variants and pricing.

Parameters

ParameterTypeRequiredDescription
product_idstringYesShopify product ID

Returns: A heading with the product title and vendor, a list of variants (SKU | Price | Stock), and the product description (HTML).

shopify_list_orders

List orders from your Shopify store.

Parameters

ParameterTypeRequiredDescription
limitnumberNoMax orders to return (default 10)
fulfillment_statusstringNoFilter: fulfilled, unfulfilled, partial
financial_statusstringNoFilter: paid, pending, refunded

Returns: A list of - **<order name>** $<total> | <financial status> | <fulfillment status> | <customer email> id: <id> lines, or "No orders found.".

shopify_get_order

Get full details of a Shopify order including line items.

Parameters

ParameterTypeRequiredDescription
order_idstringYesShopify order ID

Returns: A heading with the order name, customer email, total/financial/fulfillment status, and a list of line items (name x<quantity> @ $<price>).

shopify_list_customers

List customers from your Shopify store.

Parameters

ParameterTypeRequiredDescription
limitnumberNoMax customers (default 10)

Returns: A list of - **<first> <last>** <<email>> | <N> orders id: <id> lines, or "No customers found.".

shopify_get_customer

Get details of a Shopify customer.

Parameters

ParameterTypeRequiredDescription
customer_idstringYesShopify customer ID

Returns: A text block with the customer's name, email, phone, order count, and total amount spent.

shopify_create_product

Create a new product in your Shopify store.

Parameters

ParameterTypeRequiredDescription
titlestringYesProduct title
descriptionstringNoProduct description (HTML)
vendorstringNoProduct vendor/brand
pricestringNoPrice (e.g. 29.99)
skustringNoStock keeping unit
inventorynumberNoInitial inventory quantity

Returns: "Product created: **<title>** ID: <id>".

Next