{"_id":"@blackswampai/n8n-nodes-medusa","_rev":"3-e51cfed42cd8bbce1071cb65c582867e","name":"@blackswampai/n8n-nodes-medusa","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@blackswampai/n8n-nodes-medusa","version":"0.1.0","keywords":["n8n-community-node-package","n8n","medusa","medusajs","ecommerce","commerce"],"author":{"name":"Christopher J. Nelson","email":"christopherjnelson@proton.me"},"license":"MIT","_id":"@blackswampai/n8n-nodes-medusa@0.1.0","maintainers":[{"name":"christopherjnelson","email":"root@chris.guru"}],"homepage":"https://github.com/BlackSwampAI/n8n-nodes-medusa#readme","bugs":{"url":"https://github.com/BlackSwampAI/n8n-nodes-medusa/issues"},"n8n":{"nodes":["dist/nodes/Medusa/Medusa.node.js"],"strict":true,"credentials":["dist/credentials/MedusaApi.credentials.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"5e30511d185a2d8722d3bf0c82b4a703db8cc3c6","tarball":"https://registry.npmjs.org/@blackswampai/n8n-nodes-medusa/-/n8n-nodes-medusa-0.1.0.tgz","fileCount":108,"integrity":"sha512-ZVgCOcm1/uwwMC54HAyQlQYD+qOHB2MrbGcSGHC4QvFidKfsc4HiU8Q20W+K/DavoOcNyfRXcZksBu0hfHsk3Q==","signatures":[{"sig":"MEUCIAZk6788XjmHtsvQY7ULonQ3TfLLwnRWGnK0Uew9GeA6AiEA6JXuMfJ7FvXw56YT6jbspPH9KVqWC7qxSP1CQ6O+e/Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@blackswampai%2fn8n-nodes-medusa@0.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":332133},"engines":{"node":">=22.22.0"},"gitHead":"94f29288b52d0d01cd3dada85cca2be9fb4ea163","scripts":{"dev":"n8n-node dev","lint":"n8n-node lint","test":"vitest run","build":"n8n-node build","release":"n8n-node release","lint:fix":"n8n-node lint --fix","medusa:up":"node scripts/medusa-dev.mjs up","test:unit":"vitest run test/unit","typecheck":"tsc --noEmit -p tsconfig.test.json","test:watch":"vitest","build:watch":"tsc --watch","medusa:down":"node scripts/medusa-dev.mjs down","release:check":"node scripts/release-check.mjs","prepublishOnly":"n8n-node prerelease","test:integration":"vitest run test/integration"},"_npmUser":{"name":"christopherjnelson","email":"root@chris.guru"},"repository":{"url":"git+https://github.com/BlackSwampAI/n8n-nodes-medusa.git","type":"git"},"_npmVersion":"11.17.0","description":"n8n community node for the Medusa commerce Admin API, with first-class self-hosted support","directories":{},"_nodeVersion":"24.19.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"9.32.0","vitest":"^3.2.7","prettier":"3.6.2","release-it":"20.2.0","typescript":"5.9.2","@n8n/node-cli":"0.42.2"},"peerDependencies":{"n8n-workflow":"*"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes-medusa_0.1.0_1787169143422_0.9556699261724864","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@blackswampai/n8n-nodes-medusa","version":"0.1.1","keywords":["n8n-community-node-package","n8n","medusa","medusajs","ecommerce","commerce"],"author":{"name":"Christopher J. Nelson","email":"christopherjnelson@proton.me"},"license":"MIT","_id":"@blackswampai/n8n-nodes-medusa@0.1.1","maintainers":[{"name":"christopherjnelson","email":"root@chris.guru"}],"homepage":"https://github.com/BlackSwampAI/n8n-nodes-medusa#readme","bugs":{"url":"https://github.com/BlackSwampAI/n8n-nodes-medusa/issues"},"n8n":{"nodes":["dist/nodes/Medusa/Medusa.node.js"],"strict":true,"credentials":["dist/credentials/MedusaApi.credentials.js"],"n8nNodesApiVersion":1},"dist":{"shasum":"b06de140f07dd3b9bbb16e21becec218c8872054","tarball":"https://registry.npmjs.org/@blackswampai/n8n-nodes-medusa/-/n8n-nodes-medusa-0.1.1.tgz","fileCount":108,"integrity":"sha512-fZ/kf+zqb4+2r+oX+klBmzEh4QnSpJ1U0spT4YXRKqOYnrrkX0UFzPZJce3Otwlncglb9MWCfpsxtAgDElAZaA==","signatures":[{"sig":"MEQCIBtGCYS94v+KVTI9I6rs4+qbIdDFjSQGDflL241HayEnAiBE6M3ODXpjdLtfi0GFrtassA1XNt3BkLc4o9EeP2rPhQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@blackswampai%2fn8n-nodes-medusa@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":333021},"engines":{"node":">=22.22.0"},"gitHead":"86dd3689b36b3bf4d9d44c11c3dcc6500e9cb4b4","scripts":{"dev":"n8n-node dev","lint":"n8n-node lint","test":"vitest run","build":"n8n-node build","release":"n8n-node release","lint:fix":"n8n-node lint --fix","medusa:up":"node scripts/medusa-dev.mjs up","test:unit":"vitest run test/unit","typecheck":"tsc --noEmit -p tsconfig.test.json","test:watch":"vitest","build:watch":"tsc --watch","medusa:down":"node scripts/medusa-dev.mjs down","release:check":"node scripts/release-check.mjs","prepublishOnly":"n8n-node prerelease","test:integration":"vitest run test/integration"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d6ab92ac-a8d8-46ae-aad4-95ac979442d1"}},"repository":{"url":"git+https://github.com/BlackSwampAI/n8n-nodes-medusa.git","type":"git"},"_npmVersion":"11.17.0","description":"n8n community node for the Medusa commerce Admin API, with first-class self-hosted support","directories":{},"_nodeVersion":"24.19.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"9.32.0","vitest":"^3.2.7","prettier":"3.6.2","release-it":"20.2.0","typescript":"5.9.2","@n8n/node-cli":"0.42.2"},"peerDependencies":{"n8n-workflow":"*"},"_npmOperationalInternal":{"tmp":"tmp/n8n-nodes-medusa_0.1.1_1787251792499_0.8351825458121165","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@blackswampai/n8n-nodes-medusa","version":"0.1.2","packageManager":"npm@11.19.0","description":"n8n community node for the Medusa commerce Admin API, with first-class self-hosted support","license":"MIT","homepage":"https://blackswampai.com/n8n-nodes/medusa/","keywords":["n8n-community-node-package","n8n","medusa","medusajs","ecommerce","commerce"],"author":{"name":"Christopher J. Nelson","email":"christopherjnelson@proton.me"},"repository":{"type":"git","url":"git+https://github.com/BlackSwampAI/n8n-nodes-medusa.git"},"bugs":{"url":"https://github.com/BlackSwampAI/n8n-nodes-medusa/issues"},"scripts":{"build":"n8n-node build","format":"prettier --write .","format:check":"prettier --check .","build:watch":"tsc --watch","dev":"n8n-node dev","lint":"n8n-node lint","lint:fix":"n8n-node lint --fix","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.test.json","test":"vitest run","test:unit":"vitest run test/unit scripts","test:integration":"vitest run test/integration","test:watch":"vitest","medusa:up":"node scripts/medusa-dev.mjs up","medusa:down":"node scripts/medusa-dev.mjs down","release:check":"node scripts/release-check.mjs","scan:source":"node scripts/scan-source.mjs","scan:published":"node scripts/scan-published.mjs","package:check":"node scripts/package-check.mjs","smoke:load":"node scripts/node-load-smoke.mjs","smoke:install":"node scripts/package-install-smoke.mjs","release":"n8n-node release","prepublishOnly":"n8n-node prerelease"},"n8n":{"n8nNodesApiVersion":1,"strict":true,"credentials":["dist/credentials/MedusaApi.credentials.js"],"nodes":["dist/nodes/Medusa/Medusa.node.js"]},"devDependencies":{"@n8n/node-cli":"0.46.4","@n8n/scan-community-package":"0.34.0","eslint":"9.32.0","prettier":"3.6.2","release-it":"20.2.0","typescript":"5.9.2","vitest":"4.1.11"},"peerDependencies":{"n8n-workflow":"*"},"engines":{"node":">=22.22.0"},"publishConfig":{"access":"public"},"allowScripts":{"eslint-plugin-n8n-nodes-base":false},"gitHead":"2ffb7f4aa1d95ae4ead3446f2c4516595ee49263","_id":"@blackswampai/n8n-nodes-medusa@0.1.2","_nodeVersion":"24.20.0","_npmVersion":"11.19.0","dist":{"integrity":"sha512-tuZ4y27MUm9pKP7kQ192EI+t4gCJ3hAN01oYXMpyhJRUp2cd+8zn5Fpm8RktMo5sAjDVeTe9V+1U002Bq3KbXw==","shasum":"394e2fb9e60b87faa5f2f5a6adbc4a73ffa298fe","tarball":"https://registry.npmjs.org/@blackswampai/n8n-nodes-medusa/-/n8n-nodes-medusa-0.1.2.tgz","fileCount":108,"unpackedSize":334966,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@blackswampai%2fn8n-nodes-medusa@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEdBI2UHFDiUMn841ey/SNcwsonOHZrGHBGRuo19XR+3AiB5L4vwiZrY76WPUyel3WsqhguE7sbB2dEaTJ4vX/2xkg=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d6ab92ac-a8d8-46ae-aad4-95ac979442d1"}},"directories":{},"maintainers":[{"name":"christopherjnelson","email":"root@chris.guru"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/n8n-nodes-medusa_0.1.2_1788685555081_0.05216562388350243"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-19T19:52:23.285Z","modified":"2026-09-06T09:05:55.641Z","0.1.0":"2026-08-19T19:52:23.570Z","0.1.1":"2026-08-20T18:49:52.620Z","0.1.2":"2026-09-06T09:05:55.213Z"},"bugs":{"url":"https://github.com/BlackSwampAI/n8n-nodes-medusa/issues"},"author":{"name":"Christopher J. Nelson","email":"christopherjnelson@proton.me"},"license":"MIT","homepage":"https://blackswampai.com/n8n-nodes/medusa/","keywords":["n8n-community-node-package","n8n","medusa","medusajs","ecommerce","commerce"],"repository":{"type":"git","url":"git+https://github.com/BlackSwampAI/n8n-nodes-medusa.git"},"description":"n8n community node for the Medusa commerce Admin API, with first-class self-hosted support","maintainers":[{"name":"christopherjnelson","email":"root@chris.guru"}],"readme":"# @blackswampai/n8n-nodes-medusa\n\n[![npm version](https://img.shields.io/npm/v/%40blackswampai%2Fn8n-nodes-medusa.svg)](https://www.npmjs.com/package/@blackswampai/n8n-nodes-medusa)\n[![CI](https://github.com/BlackSwampAI/n8n-nodes-medusa/actions/workflows/ci.yml/badge.svg)](https://github.com/BlackSwampAI/n8n-nodes-medusa/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE.md)\n\nAn n8n community integration for the Medusa v2 Admin API, with first-class self-hosted support.\n\n> This is an independent Black Swamp AI community integration. It is not affiliated with, endorsed by, sponsored by, or maintained by Medusa. The Medusa name and logo belong to their respective owner(s) and are used only to identify compatibility.\n\nMedusa is an open source, self-hostable commerce platform built as a modular set of commerce\nprimitives — products, orders, inventory, fulfillment, pricing and promotions — exposed through\nan API-first Admin API. This node targets that Admin API, so it works against any Medusa\ninstallation you control, self-hosted or otherwise.\n\n[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.\n\n[Installation](#installation) · [Operations](#operations) · [Credentials](#credentials) ·\n[Compatibility](#compatibility) · [Known limitations](#known-limitations) ·\n[Troubleshooting](#troubleshooting) · [Resources](#resources) ·\n[Black Swamp AI](https://blackswampai.com/n8n-nodes/medusa/)\n\n## Installation\n\nOn the n8n canvas, open the nodes panel, search for **Medusa**, select it under **More from the\ncommunity**, and choose **Install**. On self-hosted n8n, administrators may alternatively install\nthe exact package name `@blackswampai/n8n-nodes-medusa` through Community Nodes settings.\n\n## Operations\n\n### Product\n\n| Operation | Notes                                                                                                 |\n| --------- | ----------------------------------------------------------------------------------------------------- |\n| Create    | Requires a title and at least one priced variant                                                      |\n| Get       | By ID, with optional field selection and relation expansion                                           |\n| Get Many  | Filter by search, status, handle, category, collection, and created/updated date; Return All or Limit |\n| Update    | Any subset of title, subtitle, description, handle, status, discountable, external ID and metadata    |\n| Delete    | By ID                                                                                                 |\n\nMedusa requires every product to declare at least one option axis, and every variant to carry\nmatching option values. Rather than make that mandatory, the node derives a single axis from your\nvariant titles, so creating a product needs only a title, a variant name and a price. Products\nthat genuinely vary along several dimensions — size _and_ colour — can supply the axes explicitly\nthrough the Product Options and Variant Options fields.\n\n### Product Variant\n\n| Operation | Notes                                                                        |\n| --------- | ---------------------------------------------------------------------------- |\n| Create    | On an existing product; requires a title and at least one price              |\n| Get       | By product ID and variant ID                                                 |\n| Get Many  | Variants of one product, or across every product when no product ID is given |\n| Update    | Title, SKU, barcodes, inventory tracking, metadata, and the full price list  |\n| Delete    | By product ID and variant ID                                                 |\n\nVariants are always addressed through their product, because that is how Medusa's API is shaped.\nThe cross-product route used by Get Many is the one exception, and it cannot filter by product —\nsupply a Product ID and the node switches to that product's own route instead.\n\nMedusa will not invent option values. A variant can only use option values already declared on its\nproduct, so add the value to the product first if it is new.\n\n### Product Category\n\n| Operation    | Notes                                                                  |\n| ------------ | ---------------------------------------------------------------------- |\n| Create       | Requires a name                                                        |\n| Get          | By ID                                                                  |\n| Get Many     | Filter by search, handle, parent category, active and internal flags   |\n| Update       | Name, description, handle, ranking, parent, visibility flags, metadata |\n| Delete       | By ID                                                                  |\n| Add Products | Add and remove products in one call                                    |\n\nMedusa creates categories **inactive**. Set Is Active for the category to appear in a storefront.\n\n### Product Collection\n\n| Operation    | Notes                               |\n| ------------ | ----------------------------------- |\n| Create       | Requires a title                    |\n| Get          | By ID                               |\n| Get Many     | Filter by search, title, handle     |\n| Update       | Title, handle, metadata             |\n| Delete       | By ID                               |\n| Add Products | Add and remove products in one call |\n\n### Customer\n\n| Operation  | Notes                                                                            |\n| ---------- | -------------------------------------------------------------------------------- |\n| Create     | Requires an email                                                                |\n| Get        | By ID                                                                            |\n| Get Many   | Filter by search, exact email, company, account status, and created/updated date |\n| Update     | Email, name, company, phone, metadata                                            |\n| Delete     | By ID                                                                            |\n| Set Groups | Add and remove group membership in one call                                      |\n\nMedusa will accept a customer with no fields at all, creating a record that cannot be contacted or\nmatched against an existing one. The node requires an email to prevent that.\n\n### Customer Group\n\n| Operation     | Notes                                      |\n| ------------- | ------------------------------------------ |\n| Create        | Requires a name                            |\n| Get           | By ID                                      |\n| Get Many      | Filter by search, exact name, created date |\n| Update        | Name, metadata                             |\n| Delete        | By ID                                      |\n| Set Customers | Add and remove members in one call         |\n\nMembership can be changed from either end — Customer → Set Groups, or Customer Group → Set\nCustomers — whichever fits the workflow better.\n\n### Inventory Item\n\n| Operation             | Notes                                                               |\n| --------------------- | ------------------------------------------------------------------- |\n| Create                | Requires a SKU                                                      |\n| Get                   | By ID                                                               |\n| Get Many              | Filter by search, exact SKU, created/updated date                   |\n| Update                | SKU, title, dimensions, customs fields, metadata                    |\n| Delete                | By ID                                                               |\n| Get Location Levels   | Stock held for this item across locations                           |\n| Set Location Level    | Sets stock at one location, creating the level if it does not exist |\n| Delete Location Level | Stops tracking this item at a location                              |\n\n**Set Location Level is the operation a warehouse feed wants.** Medusa splits this across two\nroutes — one that creates a level and one that updates it — and creating a level that already\nexists fails. A sync does not know which case it is in, so this operation checks and picks. That\ncosts one extra request per call.\n\nMedusa refuses to delete a level while stock remains at that location. Set the stocked quantity\nto 0 first.\n\n### Stock Location\n\n| Operation          | Notes                                            |\n| ------------------ | ------------------------------------------------ |\n| Create             | Requires a name; accepts a physical address      |\n| Get                | By ID                                            |\n| Get Many           | Filter by search, exact name                     |\n| Update             | Name, address, metadata                          |\n| Delete             | By ID                                            |\n| Set Sales Channels | Add and remove the channels this location serves |\n\n### Order\n\n| Operation                   | Notes                                                                                      |\n| --------------------------- | ------------------------------------------------------------------------------------------ |\n| Get                         | By ID                                                                                      |\n| Get Many                    | Filter by search, status, payment status, fulfillment status, region, created/updated date |\n| Get Line Items              | The order's line items                                                                     |\n| Get Changes                 | The order's change history                                                                 |\n| Update                      | Email and metadata only                                                                    |\n| Complete · Cancel · Archive | State transitions                                                                          |\n\nMedusa has **no create and no delete** for orders. Orders come from checkout, and are cancelled or\narchived rather than removed. Draft orders, which is how an order is authored administratively,\nare a separate 21-endpoint flow planned for a later release.\n\nStatus is not an editable field — Medusa rejects it in an update body — so each transition is its\nown operation, and each has preconditions Medusa enforces:\n\n- A completed order **cannot** be cancelled. Use the returns process instead.\n- A cancelled order cannot be completed.\n- An order with active fulfillments cannot be cancelled until those are cancelled first.\n- Either terminal state can be archived.\n\nSome fields, **including `email`, are not returned unless you ask for them by name** in Fields.\nThis is easy to mistake for the value being empty.\n\n### Fulfillment\n\n| Operation         | Notes                                 |\n| ----------------- | ------------------------------------- |\n| Create            | Fulfil line items on an order         |\n| Get Many          | The fulfillments of an order          |\n| Create Shipment   | Record that a fulfillment has shipped |\n| Mark as Delivered | Record delivery                       |\n| Cancel            | Only while unshipped                  |\n\nFulfillments are always addressed through their order. Medusa has **no read endpoint for\nfulfillments at all**, so Get Many reads them by expanding the order.\n\nA shipped fulfillment cannot be cancelled.\n\n### Region\n\n| Operation                        | Notes                             |\n| -------------------------------- | --------------------------------- |\n| Create                           | Requires a name and currency code |\n| Get · Get Many · Update · Delete |                                   |\n\nA country belongs to **exactly one region**. Assigning one that another region already covers is\nrejected — the most common surprise when scripting region setup.\n\n### Sales Channel\n\n| Operation                        | Notes                               |\n| -------------------------------- | ----------------------------------- |\n| Create                           | Requires a name                     |\n| Get · Get Many · Update · Delete |                                     |\n| Add Products                     | Add and remove products in one call |\n\nChannel membership is readable from the **product** side (`Product → Get` with\n`fields=id,*sales_channels`), not from the channel.\n\n### Price List\n\n| Operation                        | Notes                                  |\n| -------------------------------- | -------------------------------------- |\n| Create                           | Requires a title **and** a description |\n| Get · Get Many · Update · Delete |                                        |\n| Get Prices                       | Prices in the list                     |\n| Add Prices                       | Add variant prices                     |\n| Add Products                     | Add and remove products in one call    |\n\n### Promotion\n\n| Operation                        | Notes                                                      |\n| -------------------------------- | ---------------------------------------------------------- |\n| Create                           | Code, discount type, value, what it applies to, allocation |\n| Get · Get Many · Update · Delete |                                                            |\n\nMedusa requires a max quantity when the allocation is **Each**, and a currency for a\n**fixed-amount** discount. The node collects both and refuses early rather than letting the request\nfail. Changing the discount itself after creation is not supported — recreate the promotion\ninstead.\n\n## Not in this release\n\nReturns, exchanges, claims, order edits and draft orders are multi-step workflows rather than\nCRUD, and each needs its own design. Promotion rule builders, campaigns, reservations, batch\noperations and product import/export are also deferred.\n\nMedusa's Store API — carts, checkout and storefront browsing — is out of scope.\n\n## Credentials\n\nYou need a Medusa **secret API key**. Publishable API keys are scoped to sales channels for\nstorefront use and will not authenticate against the Admin API.\n\n1. Sign in to your Medusa admin dashboard as an administrator.\n2. Go to **Settings → Secret API Keys** and create a key.\n3. Copy the token when it is shown. Medusa displays it once.\n\nThe credential takes two fields:\n\n| Field     | Value                                                                                                                                 |\n| --------- | ------------------------------------------------------------------------------------------------------------------------------------- |\n| Base URL  | The root URL of your Medusa server, without the `/admin` path — for example `https://commerce.example.com` or `http://localhost:9000` |\n| API Token | The secret API key token                                                                                                              |\n\nMedusa's Admin API authenticates secret keys using the HTTP `Basic` scheme. The node sets that\nheader for you; you only supply the token.\n\n## Compatibility\n\n- Requires n8n with `n8nNodesApiVersion` 1.\n- Requires Node.js 22.22.0 or later.\n- Developed and tested against Medusa 2.x. Medusa v1 uses a different Admin API and is not supported.\n\n## Known limitations\n\n**Deleting a record that does not exist reports success.** Medusa answers every delete with\n`{ \"deleted\": true }` and HTTP 200, whether or not anything was there to remove:\n\n```\nDELETE /admin/products/does_not_exist  →  200  { \"id\": \"does_not_exist\", \"deleted\": true }\n```\n\nThis is Medusa's behaviour, not the node's, and it applies to every resource. A workflow that\nbranches on `deleted` is therefore confirming that the record is _gone_, not that this node removed\nit. Read the record first if you need to tell those two cases apart.\n\nMedusa has no generic outgoing webhook registration. Its events are emitted through the Event\nModule to subscribers that run inside the Medusa application itself, so there is no Admin API\nroute an external system can call to subscribe. This node therefore has no trigger — it is an\naction node. Event-driven support depends on a companion Medusa plugin that forwards events over\nHTTP, which is planned separately.\n\n## Troubleshooting\n\n- Use the Medusa server root as Base URL; do not append `/admin`.\n- Use a secret API key, not a publishable storefront key.\n- Some Admin API fields are omitted unless requested through **Fields**; an absent field is not\n  necessarily empty.\n- For delete workflows that must distinguish “removed now” from “already absent,” Get the record\n  first because Medusa reports both cases as deleted.\n\n## Resources\n\n- [n8n community nodes documentation](https://docs.n8n.io/integrations/#community-nodes)\n- [Medusa Admin API reference](https://docs.medusajs.com/api/admin)\n- [Medusa documentation](https://docs.medusajs.com/)\n- [API and observed-behavior matrix](docs/api-matrix.md)\n- [Testing and qualification](docs/testing.md)\n- [Branding provenance](docs/branding.md)\n- [Version history](CHANGELOG.md)\n\n## Release provenance\n\nReleases are published only from immutable version tags through GitHub Actions with npm\nprovenance. The official n8n scanner checks source and built artifacts before publication and the\npublished registry package afterward.\n\n## License\n\n[MIT](LICENSE.md)\n","readmeFilename":"README.md"}