shopify

name	shopify
description	An e-commerce platform for online stores and retail point-of-sale systems. Read and write Shopify (Legacy) data through One: customer, discountcode, order, product, pricerule, webhook and more, 48 actions with real parameter documentation. Use whenever the user asks to look something up in Shopify (Legacy), create or update a record there, or build code against the Shopify (Legacy) API.

Shopify (Legacy) through One

An e-commerce platform for online stores and retail point-of-sale systems.

One exposes Shopify (Legacy) through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform shopify if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Shopify (Legacy) is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Shopify (Legacy) account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Customer

Action	Method	Path	Action id
Get Customers List	GET	customers.json	conn_mod_def::F6aS3yVqhHI::Qz8HC0kkT66Tmv34-hsCNg
Get Single Customer	GET	customers/{{id}}.json	conn_mod_def::F6aS38Zedn4::EGvW_LiyRP2FIKq2ii1k6Q
Retrieve Customer Orders	GET	customers/{{id}}/orders.json	conn_mod_def::F6aS4Idx7O8::zFayn1GDRDGxfBJQRk5BYQ
Retrieves a count of customers	GET	customers/count.json	conn_mod_def::F6aS4TSsvms::_-XBw-1BSJaXrjfE9SV88w
Search for Customers	GET	/customers/search.json	conn_mod_def::F6aS4eBa82g::6bfQYGgGQpuxYbOOJAQQkg
Create Customer	POST	customers.json	conn_mod_def::F6aS3PNDDgM::15i7yhRaSbabTu8n3h9quA
Create Customer Account Activation URL	POST	customers/{{customer_id}}/account_activation_url.json	conn_mod_def::F6aS3aDC_PI::2L-bAw6CSd2gohHwH7tuVg
Delete Customer	DELETE	customers/{{id}}.json	conn_mod_def::F6aS4p5VzRw::ptPHMstLR1y6MGrJI60cGA
Send Account Invite to Customer	POST	customers/{{customer_id}}/send_invite.json	conn_mod_def::F6aS3lWLzog::GQf_YF_oRbaGpunozgbucw
Update Customer	PUT	customers/{{id}}.json	conn_mod_def::F6aS5_xPiM0::4j8-Y9LjQ_WlWx6wpm-Pzg

DiscountCode

Action	Method	Path	Action id
Get Discount Codes	GET	price_rules/{{id}}/discount_codes.json	conn_mod_def::F78Z06XtaBg::60TL_0peSjyHLLXLnoYdfg
Get Discount Codes Count	GET	discount_codes/count.json	conn_mod_def::F78Z0inSZlg::xK_-hYEBRBC7Y4rAi3u5Kw
Retrieve Discount Code Location	GET	discount_codes/lookup.json	conn_mod_def::F78ZzgCFDbg::CtqGPkMyQTayN9vuRRt78w
Retrieve Discount Codes for a Creation Job	GET	price_rules/{{price_rule_id}}/batch/{{id}}/discount_codes.json	conn_mod_def::F78Z1TNGhZA::xat0AUwPThaFncIXTf7emg
Retrieve Single Discount Code	GET	price_rules/{{price_rule_id}}/discount_codes/{{id}}.json	conn_mod_def::F78Z0yphbmA::ANZHlT55QiC9I0ztDdj91Q
Retrieves a Discount Code Creation Job	GET	price_rules/{{price_rule_id}}/batch/{{id}}.json	conn_mod_def::F78Z1wc6WAg::VsuB9GQHS0iaBbv0z0ZPAg
Create Discount Code	POST	price_rules/{{id}}/discount_codes.json	conn_mod_def::F78Z0yNpQGA::v54rxvIWSIepwGwZFxEVcg
Create Discount Code Creation Job	POST	price_rules/{{id}}/batch.json	conn_mod_def::F78Z1Mw6uwA::NrSPXiHnQ1K2daartGYrpA
Delete Discount Code	DELETE	price_rules/{{price_rule_id}}/discount_codes/{{id}}.json	conn_mod_def::F78Z1qs6yNA::brD_ccoORe2KXSqk88wJpQ
Update Discount Code	PUT	price_rules/{{price_rule_id}}/discount_codes/{{id}}.json	conn_mod_def::F78Z2Ah_1wA::hYYjAA6WTdK773GUFkcUtg

Order

Action	Method	Path	Action id
Retrieve a list of orders	GET	orders.json	conn_mod_def::F6aS5ebtKjU::5Yljc5quQQ2Szntx-O0VDA
Retrieve a Specific Order	GET	orders/{{order_id}}.json	conn_mod_def::F6aS5vCbxOE::0Iwv0JnXRcerK2K2qwp82g
Retrieve Order Count	GET	orders/count.json	conn_mod_def::F6aS6S15SEA::5vVRy4RNRlmpERGGSYrIew
Cancel an Order	POST	orders/{{order_id}}/cancel.json	conn_mod_def::F6aS4__Bw2A::LiR0skyBTQCsleC8wFqXCw
Close an Order	POST	orders/{{order_id}}/close.json	conn_mod_def::F6aS5MAwKaA::OyEvXSDcSYqD5J2NGrI2FQ
Create an Order	POST	orders.json	conn_mod_def::F6aS40oC7lg::y4L2qo6tSTSl-2R5Srt24w
Delete an Order	DELETE	orders/{{order_id}}.json	conn_mod_def::F6aS6kg7JIU::aeweSYT6SVWma467Y6sqpw
Re-open a Closed Order	POST	orders/{{order_id}}/open.json	conn_mod_def::F6aXPO37lIs::WhS80ngISPWn-Xo3i0mhIw
Update an Order	PUT	orders/{{order_id}}.json	conn_mod_def::F6aS7cqFqoU::wbtT8iE5RzmA8vbRgXQW3Q

Product

Action	Method	Path	Action id
Retrieve a count of products	GET	products/count.json	conn_mod_def::F6M0WxmLmgI::6FLS1DshQYqr3V4MS3fQoQ
Retrieve a List of Products	GET	products.json	conn_mod_def::F6M0WD0vHS0::uhL7OO3RQzOTnV7EDd3oZg
Retrieve a Single Product	GET	products/{{product_id}}.json	conn_mod_def::F6M0WYhBi2o::Q835xLFvRb2NTh1ecKYLHg
Create a new product	POST	products.json	conn_mod_def::F6M0VgIGe3Y::br7lCJOGSXikfT3PsnRh3Q
Delete a Product	DELETE	products/{{product_id}}.json	conn_mod_def::F6M0XcMD2xM::IOFH793gRM6rW6VaRKsicw
Update Product	PUT	products/{{product_id}}.json	conn_mod_def::F6M0XFOiGas::-zZvtSVRSq2Kr0Zf530FhQ

PriceRule

Action	Method	Path	Action id
Retrieve List of Price Rules	GET	price_rules.json	conn_mod_def::F78Z4wU-Uxg::Rb5jZlfPTy-a0OyKpOSuLA
Retrieve Price Rule	GET	price_rules/{{id}}.json	conn_mod_def::F78Z4sU7Fkg::8nlaDz6ESLmVsHJT1GlLdw
Retrieve Price Rule Count	GET	price_rules/count.json	conn_mod_def::F78Z2hR8DYg::KTXQ0LbeR1qvcUh1BAP33A
Create Price Rule	POST	price_rules.json	conn_mod_def::F78irz-JIpY::Xdx98pnJSB65HvwB11NXPg
Remove an existing PriceRule	DELETE	price_rules/{{id}}.json	conn_mod_def::F78Z2B-Qp9A::glLAQ5F_TOG5WAWxSwaqDA
Update Price Rule	PUT	price_rules/{{id}}.json	conn_mod_def::F78Z3BAZOdA::rfNUZORmQLex9otci5DsrA

Webhook

Action	Method	Path	Action id
Receive a Count of All Webhooks	GET	webhooks/count.json	conn_mod_def::F78Z3OzXoeA::C2n5Ht3XQ0aNnPheBgMXsA
Receive Single Webhook	GET	webhooks/{{id}}.json	conn_mod_def::F78Z41bsVAg::jGZxxfEPRCi-tHrS922m3g
Retrieve List of Webhooks	GET	webhooks.json	conn_mod_def::F78Z5bk7dsg::qQBVd-PbQDmW31yfZsI85Q
Create a new Webhook	POST	webhooks.json	conn_mod_def::F78Z4irQyHg::tpBudKCEQqOVZAsOsVo8JQ
Modify Webhook	PUT	webhooks/{{id}}.json	conn_mod_def::F78Z4e5NFXg::Dla8bBgNTCKvtnqX59V1qA
Remove Existing Webhook	DELETE	webhooks/{{id}}.json	conn_mod_def::F78Z3yALu1g::MHJ6ax8ETfiMi7ahBXUSTA

Shop

Action	Method	Path	Action id
Retrieve Shop Configuration	GET	/shop.json	conn_mod_def::F8Ciw3I8aqg::dth5m-nETk6P1BmUCx6joQ

When a call fails

The error comes from Shopify (Legacy), not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/shopify

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.