agentleFS
apideck-librariesapideck-libraries/api-skills/skills/woocommerce/SKILL.md

woocommerce

Skill4 starsChanged 3 months agoApache-2.0View on GitHub

WooCommerce integration via Apideck's Ecommerce unified API — same methods work across every connector in Ecommerce, switch by changing `serviceId`. Use when the user wants to read, write, or sync orders, products, customers, and stores in WooCommerce. Routes through Apideck with serviceId "woocommerce".

  • Reads credentials

6 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 5 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    When an endpoint isn't covered by the Ecommerce unified API, use Apideck's Proxy to call WooCommerce directly — Apideck injects auth …

    line 120

“Common” is measured: kept by at least 6 in 10 of the 5 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

WooCommerce (via Apideck)

Access WooCommerce through Apideck's Ecommerce unified API — one of 17 Ecommerce connectors that share the same method surface. Code you write here ports to Shopify, BigCommerce, Shopify (Public App) and 13 other Ecommerce connectors by changing a single serviceId string. Apideck handles auth, pagination, rate limiting, and retries so you don't write per-tenant WooCommerce plumbing.

Beta connector. WooCommerce is currently in beta on Apideck. Expect partial resource coverage and occasional mapping gaps. Always verify coverage (see below) and fall back to the Proxy API for unsupported operations.

Quick facts

When to use this skill

Activate this skill when the user explicitly wants to work with WooCommerce — for example, "list orders in WooCommerce" or "sync products in WooCommerce". This skill teaches the agent:

  1. Which Apideck unified API covers WooCommerce (Ecommerce)
  2. The correct serviceId to pass on every call (woocommerce)
  3. WooCommerce-specific auth and coverage caveats

For the full method surface (parameters, pagination, filtering), use your language SDK skill:

  • apideck-node, apideck-python, apideck-dotnet, apideck-java, apideck-go, apideck-php, or apideck-rest

For the raw OpenAPI spec:

Minimal example (TypeScript)

import { Apideck } from "@apideck/unify";

const apideck = new Apideck({
  apiKey: process.env.APIDECK_API_KEY,
  appId: process.env.APIDECK_APP_ID,
  consumerId: "your-consumer-id",
});

// List orders in WooCommerce
const { data } = await apideck.ecommerce.orders.list({
  serviceId: "woocommerce",
});

Portable across 17 Ecommerce connectors

The Apideck Ecommerce unified API exposes the same methods for every connector in its catalog. Switching from WooCommerce to another Ecommerce connector is a one-string change — no rewrite, no new SDK.

// Today — WooCommerce
await apideck.ecommerce.orders.list({ serviceId: "woocommerce" });

// Tomorrow — same code, different connector
await apideck.ecommerce.orders.list({ serviceId: "shopify" });
await apideck.ecommerce.orders.list({ serviceId: "bigcommerce" });

This is the compounding advantage of using Apideck over integrating WooCommerce directly: code against the unified Ecommerce API once, gain access to every connector in it. New connectors Apideck adds become available to your app without code changes.

WooCommerce via Apideck Ecommerce

WooCommerce is the WordPress-plugin ecommerce platform. Apideck covers the REST API for orders, products, and customers.

Entity mapping

WooCommerce entityApideck Ecommerce resource
Orderorders
Productproducts
Customercustomers
Store settingsstores
Variation (variable product)nested under products[].variants[]

Coverage highlights

  • ✅ CRUD on orders, products, customers
  • ✅ Variable products with variants
  • ❌ Shipping zones, coupons, tax settings — use Proxy
  • ❌ WooCommerce Subscriptions, Memberships (paid add-ons) — use Proxy

Auth

  • Type: API key (consumer key + consumer secret generated in WooCommerce admin), managed by Apideck Vault
  • Site binding: each connection points to one WordPress site (store URL).
  • HTTPS required: WooCommerce REST API requires HTTPS; sites using self-signed certs may fail auth.

Example: list processing orders

const { data } = await apideck.ecommerce.orders.list({
  serviceId: "woocommerce",
  filter: { status: "processing" },
});

Escape hatch: Proxy API

When an endpoint isn't covered by the Ecommerce unified API, use Apideck's Proxy to call WooCommerce directly — Apideck injects auth headers and handles token refresh. Set x-apideck-downstream-url to the target endpoint on WooCommerce's own API:

curl 'https://unify.apideck.com/proxy' \
  -H "Authorization: Bearer ${APIDECK_API_KEY}" \
  -H "x-apideck-app-id: ${APIDECK_APP_ID}" \
  -H "x-apideck-consumer-id: ${CONSUMER_ID}" \
  -H "x-apideck-service-id: woocommerce" \
  -H "x-apideck-downstream-url: <target endpoint on WooCommerce>" \
  -H "x-apideck-downstream-method: GET"

See WooCommerce's API docs for available endpoints.

Sibling connectors

Other Ecommerce connectors that share this unified API surface (same method signatures, just change serviceId):

shopify (beta), bigcommerce (beta), shopify-public-app (beta), amazon-seller-central (beta), ebay (beta), etsy (beta), magento (beta), bol-com (beta), and 8 more.

See also

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.