withoneai 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
- Find the action in the table below, or call
search_one_platform_actionswith platformshopifyif it is not listed. - Call
get_one_action_knowledgewith the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters. - Call
execute_one_actionwith 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.