> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to WooCommerce

The WooCommerce connector lets your AI agent work with WooCommerce. Scalekit handles authentication for every call, so your agent never handles credentials. It comes with 23 tools.

**Authentication:** Consumer Key and Secret
**Categories:** CRM & Sales, Marketing
**Tools:** 23: 13 read, 10 write, 0 destructive
**Users sign in with:** Username and password
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=WOOCOMMERCE)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the WooCommerce connection

   In **AgentKit > Connections**, create a WooCommerce connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'woocommerce_coupons_list',
  toolInput: {},
  connector: 'woocommerce',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="woocommerce_coupons_list",
    tool_input={},
    connection_name="woocommerce",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `woocommerce_coupons_list`

List Coupons · Read-only

List coupons in the WooCommerce store, optionally filtered by code, search text or creation date.
Returns each coupon's id, code, discount type and amount, expiry date, usage count and limits, and product and email restrictions.
Use woocommerce_coupons_list to find a coupon or check whether a code exists. Use woocommerce_coupon_create to add a coupon.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after` (`string`, optional): Only return coupons created after this date. ISO 8601 date-time in the store's timezone. Example: 2025-01-01T00:00:00.
- `before` (`string`, optional): Only return coupons created before this date. ISO 8601 date-time in the store's timezone. Example: 2025-01-01T00:00:00.
- `code` (`string`, optional): Only return the coupon with this exact code. Example: 10off.
- `exclude` (`string`, optional): Comma-separated list of coupon IDs to leave out of the results. Example: 12,15,27.
- `include` (`string`, optional): Comma-separated list of coupon IDs to limit the results to. Example: 12,15,27.
- `order` (`string`, optional): Sort direction: asc for ascending or desc for descending. WooCommerce defaults to desc. One of: `asc`, `desc`.
- `orderby` (`string`, optional): Field to sort coupons by: date, modified, id, include, title or slug. WooCommerce defaults to date. One of: `date`, `modified`, `id`, `include`, `title`, `slug`.
- `page` (`integer`, optional): Page of results to return, starting at 1. Use with per_page to walk through large result sets. Example: 2.
- `per_page` (`integer`, optional): Maximum number of coupons to return per page, from 1 to 100. WooCommerce defaults to 10. Example: 50.
- `search` (`string`, optional): Free-text search across coupons. Example: summer.

Example input: `{}`

### `woocommerce_customer_get`

Get Customer · Read-only

Get one WooCommerce customer by their ID.
Returns the customer's email, name, username, role, billing and shipping addresses, avatar URL and meta data.
Use woocommerce_customer_get when you know the customer ID. Use woocommerce_customers_list to find a customer by email or name, and woocommerce_orders_list with customer to see their orders.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`integer`, required): Numeric ID of the customer. This is the WordPress user ID; get it from woocommerce_customers_list. Example: 25.

Example input: `{"customer_id":25}`

### `woocommerce_customers_list`

List Customers · Read-only

List registered customers in the WooCommerce store, filtered by search text, email or role.
Returns each customer's id, email, name, username, billing and shipping addresses, and whether they are a paying customer.
Use woocommerce_customers_list to find a customer or their ID. Use woocommerce_customer_get when you already have the ID. Guest checkouts are not customers; find them with woocommerce_orders_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, optional): Only return the customer with this exact email address. Example: john.doe@example.com.
- `exclude` (`string`, optional): Comma-separated list of customer IDs to leave out of the results. Example: 12,15,27.
- `include` (`string`, optional): Comma-separated list of customer IDs to limit the results to. Example: 12,15,27.
- `offset` (`integer`, optional): Number of matching customers to skip before returning results. Example: 20.
- `order` (`string`, optional): Sort direction: asc for ascending or desc for descending. WooCommerce defaults to asc. One of: `asc`, `desc`.
- `orderby` (`string`, optional): Field to sort customers by: id, include, name or registered_date. WooCommerce defaults to name. One of: `id`, `include`, `name`, `registered_date`.
- `page` (`integer`, optional): Page of results to return, starting at 1. Use with per_page to walk through large result sets. Example: 2.
- `per_page` (`integer`, optional): Maximum number of customers to return per page, from 1 to 100. WooCommerce defaults to 10. Example: 50.
- `role` (`string`, optional): Only return users with this WordPress role: all, administrator, editor, author, contributor, subscriber, customer or shop_manager. WooCommerce defaults to customer. One of: `all`, `administrator`, `editor`, `author`, `contributor`, `subscriber`, `customer`, `shop_manager`.
- `search` (`string`, optional): Free-text search across customer names, email addresses and usernames. Example: john.

Example input: `{}`

### `woocommerce_order_get`

Get Order · Read-only

Get one order from the WooCommerce store by its ID.
Returns the full order: status, customer, billing and shipping addresses, line items, shipping, fee, coupon and tax lines, refunds, payment details and totals.
Use woocommerce_order_get when you know the order ID. Use woocommerce_orders_list to find an order by customer, status or search text.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_id` (`integer`, required): Numeric ID of the order. Get it from woocommerce_orders_list or the order's edit screen in WP Admin (WooCommerce > Orders). Example: 727.

Example input: `{"order_id":727}`

### `woocommerce_order_notes_list`

List Order Notes · Read-only

List the notes on a WooCommerce order, optionally only customer-facing or only internal notes.
Returns each note's id, author, note text, date and whether it was sent to the customer.
Use woocommerce_order_notes_list to read an order's history. Use woocommerce_order_note_create to add a note.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_id` (`integer`, required): Numeric ID of the order. Get it from woocommerce_orders_list or the order's edit screen in WP Admin (WooCommerce > Orders). Example: 727.
- `type` (`string`, optional): Which notes to return: any, customer (notes sent to the customer) or internal (private notes). WooCommerce defaults to any. One of: `any`, `customer`, `internal`.

Example input: `{"order_id":727}`

### `woocommerce_order_refunds_list`

List Order Refunds · Read-only

List the refunds issued on one WooCommerce order.
Returns each refund's id, amount, reason, date, who issued it, whether the payment gateway refunded the money, and refunded line items.
Use woocommerce_order_refunds_list to see what was already refunded. Use woocommerce_order_refund_create to issue a new refund.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_id` (`integer`, required): Numeric ID of the order. Get it from woocommerce_orders_list or the order's edit screen in WP Admin (WooCommerce > Orders). Example: 723.
- `after` (`string`, optional): Only return refunds created after this date. ISO 8601 date-time in the store's timezone. Example: 2025-01-01T00:00:00.
- `before` (`string`, optional): Only return refunds created before this date. ISO 8601 date-time in the store's timezone. Example: 2025-01-01T00:00:00.
- `order` (`string`, optional): Sort direction: asc for ascending or desc for descending. WooCommerce defaults to desc. One of: `asc`, `desc`.
- `page` (`integer`, optional): Page of results to return, starting at 1. Use with per_page to walk through large result sets. Example: 2.
- `per_page` (`integer`, optional): Maximum number of refunds to return per page, from 1 to 100. WooCommerce defaults to 10. Example: 50.

Example input: `{"order_id":723}`

### `woocommerce_orders_list`

List Orders · Read-only

List orders in the WooCommerce store, filtered by status, customer, product, date range or a search term.
Returns a page of orders with id, number, status, totals, currency, billing and shipping addresses, line items and dates.
Use woocommerce_orders_list to find or browse orders. Use woocommerce_order_get when you already have the order ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after` (`string`, optional): Only return orders created after this date. ISO 8601 date-time in the store's timezone. Example: 2025-01-01T00:00:00.
- `before` (`string`, optional): Only return orders created before this date. ISO 8601 date-time in the store's timezone. Example: 2025-01-01T00:00:00.
- `customer` (`integer`, optional): Only return orders placed by this customer ID. This is the WordPress user ID; get it from woocommerce_customers_list. Example: 25.
- `exclude` (`string`, optional): Comma-separated list of order IDs to leave out of the results. Example: 12,15,27.
- `include` (`string`, optional): Comma-separated list of order IDs to limit the results to. Example: 12,15,27.
- `modified_after` (`string`, optional): Only return orders modified after this date. ISO 8601 date-time in the store's timezone. Example: 2025-01-01T00:00:00.
- `modified_before` (`string`, optional): Only return orders modified before this date. ISO 8601 date-time in the store's timezone. Example: 2025-01-01T00:00:00.
- `offset` (`integer`, optional): Number of matching orders to skip before returning results. Example: 20.
- `order` (`string`, optional): Sort direction: asc for ascending or desc for descending. WooCommerce defaults to desc. One of: `asc`, `desc`.
- `orderby` (`string`, optional): Field to sort orders by: date, modified, id, include, title or slug. WooCommerce defaults to date. One of: `date`, `modified`, `id`, `include`, `title`, `slug`.
- `page` (`integer`, optional): Page of results to return, starting at 1. Use with per_page to walk through large result sets. Example: 2.
- `per_page` (`integer`, optional): Maximum number of orders to return per page, from 1 to 100. WooCommerce defaults to 10. Example: 50.
- `product` (`integer`, optional): Only return orders that contain this product ID. Get it from woocommerce_products_list or the product's edit screen in WP Admin. Example: 93.
- `search` (`string`, optional): Free-text search across orders, such as a customer name, email address or order number. Example: john.doe@example.com.
- `status` (`string`, optional): Only return orders with these statuses, as a comma-separated list. Values: any, pending, processing, on-hold, completed, cancelled, refunded, failed, trash. WooCommerce defaults to any. Example: processing,on-hold.

Example input: `{}`

### `woocommerce_product_categories_list`

List Product Categories · Read-only

List product categories in the WooCommerce store, optionally filtered by name, parent, product or slug.
Returns each category's id, name, slug, parent, description, image and product count.
Use woocommerce_product_categories_list to find category IDs for products, coupons or the category filter of woocommerce_products_list. Use woocommerce_product_category_create to add a category.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `exclude` (`string`, optional): Comma-separated list of category IDs to leave out of the results. Example: 12,15,27.
- `hide_empty` (`boolean`, optional): Set to true to leave out categories that have no products. WooCommerce defaults to false.
- `include` (`string`, optional): Comma-separated list of category IDs to limit the results to. Example: 12,15,27.
- `order` (`string`, optional): Sort direction: asc for ascending or desc for descending. WooCommerce defaults to asc. One of: `asc`, `desc`.
- `orderby` (`string`, optional): Field to sort categories by: id, include, name, slug, term_group, description or count. WooCommerce defaults to name. One of: `id`, `include`, `name`, `slug`, `term_group`, `description`, `count`.
- `page` (`integer`, optional): Page of results to return, starting at 1. Use with per_page to walk through large result sets. Example: 2.
- `parent` (`integer`, optional): Only return direct children of this category ID; use 0 for top-level categories. Example: 0.
- `per_page` (`integer`, optional): Maximum number of categories to return per page, from 1 to 100. WooCommerce defaults to 10. Example: 50.
- `product` (`integer`, optional): Only return categories assigned to this product ID. Get it from woocommerce_products_list or the product's edit screen in WP Admin. Example: 794.
- `search` (`string`, optional): Free-text search on category names. Example: clothing.
- `slug` (`string`, optional): Only return the category with this slug. Example: hoodies.

Example input: `{}`

### `woocommerce_product_get`

Get Product · Read-only

Get one product from the WooCommerce catalog by its ID.
Returns the full product: name, type, status, descriptions, SKU, prices, stock, dimensions, categories, tags, images, attributes and variation IDs.
Use woocommerce_product_get when you know the product ID. Use woocommerce_products_list to find a product by name or SKU.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `product_id` (`integer`, required): Numeric ID of the product. Get it from woocommerce_products_list or the product's edit screen in WP Admin. Example: 794.

Example input: `{"product_id":794}`

### `woocommerce_product_variations_list`

List Product Variations · Read-only

List the variations of a variable WooCommerce product, such as each size and color combination.
Returns each variation's id, SKU, attributes, prices, stock status and quantity, and image.
Use woocommerce_product_variations_list to see a variable product's variations, for example to get a variation_id for woocommerce_order_create. Use woocommerce_product_get for the parent product.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `product_id` (`integer`, required): Numeric ID of the variable product. Get it from woocommerce_products_list or the product's edit screen in WP Admin. It must be a variable product. Example: 22.
- `exclude` (`string`, optional): Comma-separated list of variation IDs to leave out of the results. Example: 12,15,27.
- `include` (`string`, optional): Comma-separated list of variation IDs to limit the results to. Example: 12,15,27.
- `max_price` (`string`, optional): Only return variations priced at or below this amount. Example: 100.
- `min_price` (`string`, optional): Only return variations priced at or above this amount. Example: 10.
- `on_sale` (`boolean`, optional): Set to true to return only variations that are on sale.
- `order` (`string`, optional): Sort direction: asc for ascending or desc for descending. WooCommerce defaults to desc. One of: `asc`, `desc`.
- `orderby` (`string`, optional): Field to sort variations by: date, modified, id, include, title or slug. WooCommerce defaults to date. One of: `date`, `modified`, `id`, `include`, `title`, `slug`.
- `page` (`integer`, optional): Page of results to return, starting at 1. Use with per_page to walk through large result sets. Example: 2.
- `per_page` (`integer`, optional): Maximum number of variations to return per page, from 1 to 100. WooCommerce defaults to 10. Example: 50.
- `search` (`string`, optional): Free-text search within the variations. Example: blue.
- `sku` (`string`, optional): Only return the variation with this SKU. Example: WOO-HOODIE-BLU-L.
- `status` (`string`, optional): Only return variations with this status: any, draft, pending, private or publish. WooCommerce defaults to any. One of: `any`, `draft`, `pending`, `private`, `publish`.
- `stock_status` (`string`, optional): Only return variations with this stock status: instock, outofstock or onbackorder. One of: `instock`, `outofstock`, `onbackorder`.

Example input: `{"product_id":22}`

### `woocommerce_products_list`

List Products · Read-only

List products in the WooCommerce catalog, filtered by search text, SKU, category, tag, type, status, stock status, price or date.
Returns a page of products with id, name, type, status, SKU, prices, stock, categories, images and variation IDs.
Use woocommerce_products_list to find or browse products. Use woocommerce_product_get when you have the product ID, and woocommerce_product_variations_list for a variable product's variations.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `after` (`string`, optional): Only return products published after this date. ISO 8601 date-time in the store's timezone. Example: 2025-01-01T00:00:00.
- `before` (`string`, optional): Only return products published before this date. ISO 8601 date-time in the store's timezone. Example: 2025-01-01T00:00:00.
- `category` (`string`, optional): Only return products in this category ID. Get category IDs from woocommerce_product_categories_list. Example: 9.
- `exclude` (`string`, optional): Comma-separated list of product IDs to leave out of the results. Example: 12,15,27.
- `featured` (`boolean`, optional): Set to true to return only featured products.
- `include` (`string`, optional): Comma-separated list of product IDs to limit the results to. Example: 12,15,27.
- `max_price` (`string`, optional): Only return products priced at or below this amount. Example: 100.
- `min_price` (`string`, optional): Only return products priced at or above this amount. Example: 10.
- `modified_after` (`string`, optional): Only return products modified after this date. ISO 8601 date-time in the store's timezone. Example: 2025-01-01T00:00:00.
- `on_sale` (`boolean`, optional): Set to true to return only products that are on sale.
- `order` (`string`, optional): Sort direction: asc for ascending or desc for descending. WooCommerce defaults to desc. One of: `asc`, `desc`.
- `orderby` (`string`, optional): Field to sort products by: date, modified, id, include, title, slug, price, popularity, rating or menu_order. WooCommerce defaults to date. One of: `date`, `modified`, `id`, `include`, `title`, `slug`, `price`, `popularity`, `rating`, `menu_order`.
- `page` (`integer`, optional): Page of results to return, starting at 1. Use with per_page to walk through large result sets. Example: 2.
- `per_page` (`integer`, optional): Maximum number of products to return per page, from 1 to 100. WooCommerce defaults to 10. Example: 50.
- `search` (`string`, optional): Free-text search on product name and content. Example: hoodie.
- `sku` (`string`, optional): Only return the product with this SKU. Example: WOO-HOODIE-BLU.
- `status` (`string`, optional): Only return products with this status: any, draft, pending, private or publish. WooCommerce defaults to any. One of: `any`, `draft`, `pending`, `private`, `publish`.
- `stock_status` (`string`, optional): Only return products with this stock status: instock, outofstock or onbackorder. One of: `instock`, `outofstock`, `onbackorder`.
- `tag` (`string`, optional): Only return products with this product tag ID. Example: 34.
- `type` (`string`, optional): Only return products of this type: simple, grouped, external or variable. One of: `simple`, `grouped`, `external`, `variable`.

Example input: `{}`

### `woocommerce_sales_report_get`

Get Sales Report · Read-only

Get the WooCommerce sales report for a preset period or a custom date range.
Returns total and net sales, average sales, order and item counts, tax, shipping, refunds and discounts, plus totals grouped by day or month.
Use woocommerce_sales_report_get for revenue figures. Use woocommerce_top_sellers_report_get for the best-selling products.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date_max` (`string`, optional): End date of a custom range, in YYYY-MM-DD format. Use with date_min. Example: 2025-01-31.
- `date_min` (`string`, optional): Start date of a custom range, in YYYY-MM-DD format. Use with date_max. Example: 2025-01-01.
- `period` (`string`, optional): Preset report period: week, month, last_month or year. A preset period overrides date_min and date_max. Leave it empty to use date_min and date_max, or today when no dates are set. One of: `week`, `month`, `last_month`, `year`.

Example input: `{}`

### `woocommerce_top_sellers_report_get`

Get Top Sellers Report · Read-only

Get the best-selling products in the WooCommerce store for a preset period or a custom date range.
Returns a list of products with name, product_id and quantity sold, highest first. The product name is in name, not title.
Use woocommerce_top_sellers_report_get to see what sells best. Use woocommerce_sales_report_get for revenue totals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date_max` (`string`, optional): End date of a custom range, in YYYY-MM-DD format. Use with date_min. Example: 2025-01-31.
- `date_min` (`string`, optional): Start date of a custom range, in YYYY-MM-DD format. Use with date_max. Example: 2025-01-01.
- `period` (`string`, optional): Preset report period: week, month, last_month or year. A preset period overrides date_min and date_max. Leave it empty to use date_min and date_max, or today when no dates are set. One of: `week`, `month`, `last_month`, `year`.

Example input: `{}`

### `woocommerce_coupon_create`

Create Coupon · Write

Create a discount coupon in the WooCommerce store with its code, discount type and amount, expiry and usage restrictions.
Returns the new coupon with its id and saved settings.
Use woocommerce_coupon_create to add a coupon. Use woocommerce_coupons_list first to check that the code is not taken.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `code` (`string`, required): Coupon code that customers enter at checkout; must be unique in the store. Example: 10off.
- `amount` (`string`, optional): Discount amount as a number in a string, also for a percentage. Example: 10 for 10% off with discount_type percent.
- `date_expires` (`string`, optional): Date the coupon expires, in the store's timezone (ISO 8601). Example: 2025-12-31T23:59:59.
- `description` (`string`, optional): Internal description of the coupon. Example: Black Friday 2025 newsletter offer.
- `discount_type` (`string`, optional): Type of discount: percent (percentage off the cart), fixed_cart (fixed amount off the cart) or fixed_product (fixed amount off each matching product). WooCommerce defaults to fixed_cart. One of: `percent`, `fixed_cart`, `fixed_product`.
- `email_restrictions` (`array`, optional): Billing email addresses allowed to use the coupon; leave out to allow everyone. Example: ["john.doe@example.com"].
- `exclude_sale_items` (`boolean`, optional): Set to true so the coupon does not apply to items that are already on sale. WooCommerce defaults to false.
- `excluded_product_categories` (`array`, optional): Product category IDs the coupon never applies to. Example: [9, 14].
- `excluded_product_ids` (`array`, optional): Product IDs the coupon never applies to. Example: [93, 22].
- `free_shipping` (`boolean`, optional): Set to true to grant free shipping, when the store has a free shipping method that requires a coupon. WooCommerce defaults to false.
- `individual_use` (`boolean`, optional): Set to true so the coupon cannot be combined with other coupons. WooCommerce defaults to false.
- `limit_usage_to_x_items` (`integer`, optional): Maximum number of cart items the discount applies to. Example: 3.
- `maximum_amount` (`string`, optional): Maximum cart subtotal allowed to use the coupon. Example: 500.00.
- `meta_data` (`array`, optional): Custom meta data to store on the coupon, as a list of key/value objects. Sending a key that already exists updates its value. Example: [{"key": "gift_message", "value": "Happy birthday!"}].
- `minimum_amount` (`string`, optional): Minimum cart subtotal needed to use the coupon. Example: 100.00.
- `product_categories` (`array`, optional): Product category IDs the coupon applies to (from woocommerce_product_categories_list). Example: [9, 14].
- `product_ids` (`array`, optional): Product IDs the coupon applies to; leave out to apply to all products. Example: [93, 22].
- `usage_limit` (`integer`, optional): Total number of times the coupon can be used across all customers. Example: 100.
- `usage_limit_per_user` (`integer`, optional): Number of times each customer can use the coupon. Example: 1.

Example input: `{"code":"<code>"}`

### `woocommerce_customer_create`

Create Customer · Write

Create a customer account in the WooCommerce store with email, name, login and billing and shipping addresses.
Returns the new customer with their id and saved details.
Use woocommerce_customer_create for a new customer. Use woocommerce_customers_list with email first to avoid a duplicate, and woocommerce_customer_update to change an existing customer.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): Customer's email address, which must not already be registered. Example: john.doe@example.com.
- `billing` (`object`, optional): Billing address as an object. Supported keys: first_name, last_name, company, address_1, address_2, city, state (ISO code or name), postcode, country (ISO 3166-1 alpha-2 code), email and phone. Only the keys you send are set. Example: {"first_name": "John", "last_name": "Doe", "address_1": "969 Market", "city": "San Francisco", "state": "CA", "postcode": "94103", "country": "US", "email": "john.doe@example.com", "phone": "(555) 555-5555"}.
- `first_name` (`string`, optional): Customer's first name. Example: John.
- `last_name` (`string`, optional): Customer's last name. Example: Doe.
- `meta_data` (`array`, optional): Custom meta data to store on the customer, as a list of key/value objects. Sending a key that already exists updates its value. Example: [{"key": "gift_message", "value": "Happy birthday!"}].
- `password` (`string`, optional): Password for the customer's store account. If left out, WooCommerce may generate one, depending on the store's account settings. Example: S3cure-Pass!
- `shipping` (`object`, optional): Shipping address as an object with the same keys as the billing address except email and phone: first_name, last_name, company, address_1, address_2, city, state, postcode and country (ISO 3166-1 alpha-2 code). Example: {"first_name": "John", "last_name": "Doe", "address_1": "969 Market", "city": "San Francisco", "state": "CA", "postcode": "94103", "country": "US"}.
- `username` (`string`, optional): Login name for the customer's account. If left out, WooCommerce may generate one from the email, depending on the store's account settings. Example: john.doe.

Example input: `{"email":"<email>"}`

### `woocommerce_customer_update`

Update Customer · Write

Update an existing WooCommerce customer's email, name, password, addresses or meta data.
Returns the updated customer.
Use woocommerce_customer_update to change a customer. Use woocommerce_customer_create to add a new one.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`integer`, required): Numeric ID of the customer. This is the WordPress user ID; get it from woocommerce_customers_list. Example: 25.
- `billing` (`object`, optional): Billing address as an object. Supported keys: first_name, last_name, company, address_1, address_2, city, state (ISO code or name), postcode, country (ISO 3166-1 alpha-2 code), email and phone. Only the keys you send are set. Example: {"first_name": "John", "last_name": "Doe", "address_1": "969 Market", "city": "San Francisco", "state": "CA", "postcode": "94103", "country": "US", "email": "john.doe@example.com", "phone": "(555) 555-5555"}.
- `email` (`string`, optional): Customer's email address. Example: john.doe@example.com.
- `first_name` (`string`, optional): Customer's first name. Example: John.
- `last_name` (`string`, optional): Customer's last name. Example: Doe.
- `meta_data` (`array`, optional): Custom meta data to store on the customer, as a list of key/value objects. Sending a key that already exists updates its value. Example: [{"key": "gift_message", "value": "Happy birthday!"}].
- `password` (`string`, optional): Password for the customer's store account. Example: S3cure-Pass!
- `shipping` (`object`, optional): Shipping address as an object with the same keys as the billing address except email and phone: first_name, last_name, company, address_1, address_2, city, state, postcode and country (ISO 3166-1 alpha-2 code). Example: {"first_name": "John", "last_name": "Doe", "address_1": "969 Market", "city": "San Francisco", "state": "CA", "postcode": "94103", "country": "US"}.

Example input: `{"customer_id":25}`

### `woocommerce_order_create`

Create Order · Write

Create an order in the WooCommerce store with line items, customer, addresses, shipping, fees and coupons.
Returns the new order with its id, number, status and calculated totals.
Use woocommerce_order_create for a new order. Use woocommerce_order_update to change an existing order.
Get product IDs from woocommerce_products_list and customer IDs from woocommerce_customers_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `billing` (`object`, optional): Billing address as an object. Supported keys: first_name, last_name, company, address_1, address_2, city, state (ISO code or name), postcode, country (ISO 3166-1 alpha-2 code), email and phone. Only the keys you send are set. Example: {"first_name": "John", "last_name": "Doe", "address_1": "969 Market", "city": "San Francisco", "state": "CA", "postcode": "94103", "country": "US", "email": "john.doe@example.com", "phone": "(555) 555-5555"}.
- `coupon_lines` (`array`, optional): Coupons to apply to the order, as a list of objects with the coupon code. Example: [{"code": "10off"}].
- `customer_id` (`integer`, optional): ID of the customer who owns the order; 0 for a guest order. This is the WordPress user ID; get it from woocommerce_customers_list. Example: 25.
- `customer_note` (`string`, optional): Note from the customer, as if left at checkout. Example: Please leave the parcel at the back door.
- `fee_lines` (`array`, optional): Extra fees on the order. Each line has a name, a total as a string, and optionally tax_status (taxable or none) and tax_class. Example: [{"name": "Gift wrap", "total": "5.00", "tax_status": "none"}].
- `line_items` (`array`, optional): Products to put on the order. Each item needs a product_id and a quantity; add variation_id for a variable product, and optionally subtotal and total (strings) to override the price. Example: [{"product_id": 93, "quantity": 2}, {"product_id": 22, "variation_id": 23, "quantity": 1}].
- `meta_data` (`array`, optional): Custom meta data to store on the order, as a list of key/value objects. Sending a key that already exists updates its value. Example: [{"key": "gift_message", "value": "Happy birthday!"}].
- `payment_method` (`string`, optional): ID of the payment gateway, such as bacs, cheque, cod, stripe or paypal. Example: bacs.
- `payment_method_title` (`string`, optional): Payment method name shown to the customer. Example: Direct Bank Transfer.
- `set_paid` (`boolean`, optional): Set to true to mark the order as paid. This sets the status to processing and reduces stock. WooCommerce defaults to false.
- `shipping` (`object`, optional): Shipping address as an object with the same keys as the billing address except email and phone: first_name, last_name, company, address_1, address_2, city, state, postcode and country (ISO 3166-1 alpha-2 code). Example: {"first_name": "John", "last_name": "Doe", "address_1": "969 Market", "city": "San Francisco", "state": "CA", "postcode": "94103", "country": "US"}.
- `shipping_lines` (`array`, optional): Shipping charges on the order. Each line has a method_id (for example flat_rate or free_shipping), a method_title shown to the customer, and a total as a string. Example: [{"method_id": "flat_rate", "method_title": "Flat Rate", "total": "10.00"}].
- `status` (`string`, optional): Order status. One of pending, processing, on-hold, completed, cancelled, refunded or failed. WooCommerce defaults to pending. One of: `pending`, `processing`, `on-hold`, `completed`, `cancelled`, `refunded`, `failed`.
- `transaction_id` (`string`, optional): Transaction ID from the payment gateway. Example: ch_3NqYbF2eZvKYlo2C0.

Example input: `{}`

### `woocommerce_order_note_create`

Add Order Note · Write

Add a note to a WooCommerce order, either private for store staff or sent to the customer by email.
Returns the new note with its id, author, text and date.
Use woocommerce_order_note_create to record or communicate something about an order. Use woocommerce_order_notes_list to read existing notes.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `note` (`string`, required): Text of the note. Example: Customer called to confirm the delivery address.
- `order_id` (`integer`, required): Numeric ID of the order. Get it from woocommerce_orders_list or the order's edit screen in WP Admin (WooCommerce > Orders). Example: 727.
- `added_by_user` (`boolean`, optional): Set to true to attribute the note to the API key's user instead of the system. WooCommerce defaults to false.
- `customer_note` (`boolean`, optional): Set to true to show the note to the customer and email it to them; false keeps it as a private admin note. WooCommerce defaults to false.

Example input: `{"note":"<note>","order_id":727}`

### `woocommerce_order_refund_create`

Create Order Refund · Write

Refund a WooCommerce order in full or in part, by amount or by line item, and optionally send the money back through the payment gateway.
Returns the new refund with its id, amount, reason, refunded line items and whether the gateway refunded the payment.
Use woocommerce_order_refund_create to issue a refund. Use woocommerce_order_refunds_list to check earlier refunds first.
Get line item IDs from woocommerce_order_get.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `order_id` (`integer`, required): Numeric ID of the order. Get it from woocommerce_orders_list or the order's edit screen in WP Admin (WooCommerce > Orders). Example: 723.
- `amount` (`string`, optional): Total amount to refund, as a decimal string. If set, it takes precedence over the line item totals. Example: 30.00.
- `api_refund` (`boolean`, optional): When true, WooCommerce asks the order's payment gateway to send the money back to the customer; when false, the refund is only recorded in WooCommerce. WooCommerce defaults to true, and fails the request if the gateway does not support automatic refunds.
- `api_restock` (`boolean`, optional): When true, the refunded line item quantities are returned to stock. WooCommerce defaults to true.
- `compute_totals` (`boolean`, optional): When true, WooCommerce works out each line's refund amount from the order's prices and taxes, so line items need only id and quantity. Requires WooCommerce 11.1 or later. WooCommerce defaults to false.
- `line_items` (`array`, optional): Order line items to refund. Each object has the order line item id (from woocommerce_order_get, not the product ID), and either refund_total (amount as a number) with optional refund_tax (a list of {id, refund_total} per tax rate), or a quantity when compute_totals is true. Example: [{"id": 111, "quantity": 1, "refund_total": 10}].
- `meta_data` (`array`, optional): Custom meta data to store on the refund, as a list of key/value objects. Sending a key that already exists updates its value. Example: [{"key": "gift_message", "value": "Happy birthday!"}].
- `reason` (`string`, optional): Reason for the refund, saved on the refund. Example: Item arrived damaged.
- `refunded_by` (`integer`, optional): WordPress user ID to record as the person who issued the refund. Example: 1.

Example input: `{"order_id":723}`

### `woocommerce_order_update`

Update Order · Write

Update an existing WooCommerce order, such as its status, addresses, line items, payment details or meta data.
Returns the updated order.
Use woocommerce_order_update to change an order. Use woocommerce_order_note_create to add a note, and woocommerce_order_refund_create to refund it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `order_id` (`integer`, required): Numeric ID of the order. Get it from woocommerce_orders_list or the order's edit screen in WP Admin (WooCommerce > Orders). Example: 727.
- `billing` (`object`, optional): Billing address as an object. Supported keys: first_name, last_name, company, address_1, address_2, city, state (ISO code or name), postcode, country (ISO 3166-1 alpha-2 code), email and phone. Only the keys you send are set. Example: {"first_name": "John", "last_name": "Doe", "address_1": "969 Market", "city": "San Francisco", "state": "CA", "postcode": "94103", "country": "US", "email": "john.doe@example.com", "phone": "(555) 555-5555"}.
- `coupon_lines` (`array`, optional): Coupons to apply to the order, as a list of objects with the coupon code. Example: [{"code": "10off"}].
- `customer_id` (`integer`, optional): ID of the customer who owns the order; 0 for a guest order. This is the WordPress user ID; get it from woocommerce_customers_list. Example: 25.
- `customer_note` (`string`, optional): Note from the customer, as if left at checkout. Example: Please leave the parcel at the back door.
- `fee_lines` (`array`, optional): Extra fees on the order. Each line has a name, a total as a string, and optionally tax_status (taxable or none) and tax_class. Example: [{"name": "Gift wrap", "total": "5.00", "tax_status": "none"}].
- `line_items` (`array`, optional): Line items to add or change. To change an existing item send its id (from woocommerce_order_get) with the new quantity; to add a product send product_id and quantity without an id; to remove an item send its id with quantity 0. Example: [{"id": 315, "quantity": 3}, {"product_id": 22, "quantity": 1}].
- `meta_data` (`array`, optional): Custom meta data to store on the order, as a list of key/value objects. Sending a key that already exists updates its value. Example: [{"key": "gift_message", "value": "Happy birthday!"}].
- `payment_method` (`string`, optional): ID of the payment gateway, such as bacs, cheque, cod, stripe or paypal. Example: bacs.
- `payment_method_title` (`string`, optional): Payment method name shown to the customer. Example: Direct Bank Transfer.
- `set_paid` (`boolean`, optional): Set to true to mark the order as paid. This sets the status to processing and reduces stock. WooCommerce defaults to false.
- `shipping` (`object`, optional): Shipping address as an object with the same keys as the billing address except email and phone: first_name, last_name, company, address_1, address_2, city, state, postcode and country (ISO 3166-1 alpha-2 code). Example: {"first_name": "John", "last_name": "Doe", "address_1": "969 Market", "city": "San Francisco", "state": "CA", "postcode": "94103", "country": "US"}.
- `shipping_lines` (`array`, optional): Shipping charges on the order. Each line has a method_id (for example flat_rate or free_shipping), a method_title shown to the customer, and a total as a string. Example: [{"method_id": "flat_rate", "method_title": "Flat Rate", "total": "10.00"}].
- `status` (`string`, optional): Order status. One of pending, processing, on-hold, completed, cancelled, refunded or failed. Changing the status can send customer emails (for example completed). One of: `pending`, `processing`, `on-hold`, `completed`, `cancelled`, `refunded`, `failed`.
- `transaction_id` (`string`, optional): Transaction ID from the payment gateway. Example: ch_3NqYbF2eZvKYlo2C0.

Example input: `{"order_id":727}`

### `woocommerce_product_category_create`

Create Product Category · Write

Create a product category in the WooCommerce store, optionally as a subcategory with a description and image.
Returns the new category with its id, slug and parent.
Use woocommerce_product_category_create to add a category. Use woocommerce_product_categories_list to check whether it already exists.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Category name. Example: Hoodies.
- `description` (`string`, optional): Category description; HTML is allowed. Example: Warm hoodies for every season.
- `display` (`string`, optional): What the category archive page shows: default, products, subcategories or both. WooCommerce defaults to default. One of: `default`, `products`, `subcategories`, `both`.
- `image` (`object`, optional): Category image as an object with src (a public image URL) or id (a Media Library attachment ID), and optionally alt. Example: {"src": "https://example.com/images/hoodies.jpg"}.
- `menu_order` (`integer`, optional): Position used to sort categories manually; lower numbers come first. Example: 1.
- `parent` (`integer`, optional): ID of the parent category, to make this a subcategory. Get it from woocommerce_product_categories_list. Example: 9.
- `slug` (`string`, optional): URL slug for the category; generated from the name if left out. Example: hoodies.

Example input: `{"name":"<name>"}`

### `woocommerce_product_create`

Create Product · Write

Create a product in the WooCommerce catalog with its name, type, prices, descriptions, SKU, stock, categories, images and attributes.
Returns the new product with its id, permalink and all saved fields.
Use woocommerce_product_create for a new product. Use woocommerce_product_update to change an existing one.
Get category IDs from woocommerce_product_categories_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Product name. Example: Premium Quality Hoodie.
- `attributes` (`array`, optional): Product attributes. Each object has an id (for a global attribute) or a name (for a custom one), the options (list of term names), and visible and variation flags. Set variation to true for attributes used to build variations of a variable product. Example: [{"name": "Color", "options": ["Blue", "Red"], "visible": true, "variation": true}].
- `catalog_visibility` (`string`, optional): Where the product appears: visible (shop and search), catalog (shop only), search (search only) or hidden. One of: `visible`, `catalog`, `search`, `hidden`.
- `categories` (`array`, optional): Categories to assign, as a list of objects with the category id. This replaces the product's current categories. Get IDs from woocommerce_product_categories_list. Example: [{"id": 9}, {"id": 14}].
- `description` (`string`, optional): Full product description; HTML is allowed. Example: Soft cotton hoodie with a front pocket.

- `dimensions` (`object`, optional): Dimensions in the store's unit, as an object with length, width and height strings. Example: {"length": "30", "width": "20", "height": "5"}.
- `downloadable` (`boolean`, optional): Set to true for a downloadable product.
- `featured` (`boolean`, optional): Set to true to mark the product as featured.
- `images` (`array`, optional): Product images. Each object has src (a public image URL that WooCommerce downloads into the Media Library) or id (an existing Media Library attachment ID), and optionally alt and name. The first image is the main image. Example: [{"src": "https://example.com/images/hoodie.jpg", "alt": "Blue hoodie"}].
- `manage_stock` (`boolean`, optional): Set to true to track stock quantity for this product.
- `meta_data` (`array`, optional): Custom meta data to store on the product, as a list of key/value objects. Sending a key that already exists updates its value. Example: [{"key": "gift_message", "value": "Happy birthday!"}].
- `regular_price` (`string`, optional): Regular price as a decimal string. Example: 21.99.
- `sale_price` (`string`, optional): Sale price as a decimal string; send an empty string to end a sale. Example: 18.99.
- `short_description` (`string`, optional): Short product summary shown near the price; HTML is allowed. Example: Soft cotton hoodie.
- `sku` (`string`, optional): Stock keeping unit; must be unique in the store. Example: WOO-HOODIE-BLU.
- `status` (`string`, optional): Publication status: draft, pending, private or publish. WooCommerce defaults to publish. One of: `draft`, `pending`, `private`, `publish`.
- `stock_quantity` (`integer`, optional): Stock quantity; only used when manage_stock is true. Example: 25.
- `stock_status` (`string`, optional): Stock status: instock, outofstock or onbackorder. Ignored when manage_stock is true, because WooCommerce sets it from the quantity. One of: `instock`, `outofstock`, `onbackorder`.
- `tags` (`array`, optional): Product tags to assign, as a list of objects with the tag id. This replaces the product's current tags. Example: [{"id": 34}].
- `tax_class` (`string`, optional): Tax class slug, such as reduced-rate or zero-rate. Leave empty for the standard rate. Example: reduced-rate.
- `tax_status` (`string`, optional): Tax status: taxable, shipping (only shipping is taxed) or none. One of: `taxable`, `shipping`, `none`.
- `type` (`string`, optional): Product type: simple, grouped, external or variable. WooCommerce defaults to simple. One of: `simple`, `grouped`, `external`, `variable`.
- `virtual` (`boolean`, optional): Set to true for a virtual product that is not shipped.
- `weight` (`string`, optional): Weight in the store's weight unit, as a string. Example: 0.5.

Example input: `{"name":"<name>"}`

### `woocommerce_product_update`

Update Product · Write

Update an existing WooCommerce product, such as its prices, sale dates, stock, status, descriptions, categories or images.
Returns the updated product.
Use woocommerce_product_update to change a product. Use woocommerce_product_create to add a new one.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `product_id` (`integer`, required): Numeric ID of the product. Get it from woocommerce_products_list or the product's edit screen in WP Admin. Example: 794.
- `attributes` (`array`, optional): Product attributes. Each object has an id (for a global attribute) or a name (for a custom one), the options (list of term names), and visible and variation flags. Set variation to true for attributes used to build variations of a variable product. Example: [{"name": "Color", "options": ["Blue", "Red"], "visible": true, "variation": true}].
- `catalog_visibility` (`string`, optional): Where the product appears: visible (shop and search), catalog (shop only), search (search only) or hidden. One of: `visible`, `catalog`, `search`, `hidden`.
- `categories` (`array`, optional): Categories to assign, as a list of objects with the category id. This replaces the product's current categories. Get IDs from woocommerce_product_categories_list. Example: [{"id": 9}, {"id": 14}].
- `date_on_sale_from` (`string`, optional): Start of the sale price, in the store's timezone (ISO 8601). Example: 2025-11-28T00:00:00.
- `date_on_sale_to` (`string`, optional): End of the sale price, in the store's timezone (ISO 8601). Example: 2025-12-01T23:59:59.
- `description` (`string`, optional): Full product description; HTML is allowed. Example: Soft cotton hoodie with a front pocket.

- `dimensions` (`object`, optional): Dimensions in the store's unit, as an object with length, width and height strings. Example: {"length": "30", "width": "20", "height": "5"}.
- `downloadable` (`boolean`, optional): Set to true for a downloadable product.
- `featured` (`boolean`, optional): Set to true to mark the product as featured.
- `images` (`array`, optional): Product images. Each object has src (a public image URL that WooCommerce downloads into the Media Library) or id (an existing Media Library attachment ID), and optionally alt and name. The first image is the main image. Example: [{"src": "https://example.com/images/hoodie.jpg", "alt": "Blue hoodie"}].
- `manage_stock` (`boolean`, optional): Set to true to track stock quantity for this product.
- `meta_data` (`array`, optional): Custom meta data to store on the product, as a list of key/value objects. Sending a key that already exists updates its value. Example: [{"key": "gift_message", "value": "Happy birthday!"}].
- `name` (`string`, optional): Product name. Example: Premium Quality Hoodie.
- `regular_price` (`string`, optional): Regular price as a decimal string. Example: 21.99.
- `sale_price` (`string`, optional): Sale price as a decimal string; send an empty string to end a sale. Example: 18.99.
- `short_description` (`string`, optional): Short product summary shown near the price; HTML is allowed. Example: Soft cotton hoodie.
- `sku` (`string`, optional): Stock keeping unit; must be unique in the store. Example: WOO-HOODIE-BLU.
- `status` (`string`, optional): Publication status: draft, pending, private or publish. One of: `draft`, `pending`, `private`, `publish`.
- `stock_quantity` (`integer`, optional): Stock quantity; only used when manage_stock is true. Example: 25.
- `stock_status` (`string`, optional): Stock status: instock, outofstock or onbackorder. Ignored when manage_stock is true, because WooCommerce sets it from the quantity. One of: `instock`, `outofstock`, `onbackorder`.
- `tags` (`array`, optional): Product tags to assign, as a list of objects with the tag id. This replaces the product's current tags. Example: [{"id": 34}].
- `tax_class` (`string`, optional): Tax class slug, such as reduced-rate or zero-rate. Leave empty for the standard rate. Example: reduced-rate.
- `tax_status` (`string`, optional): Tax status: taxable, shipping (only shipping is taxed) or none. One of: `taxable`, `shipping`, `none`.
- `type` (`string`, optional): Product type: simple, grouped, external or variable. One of: `simple`, `grouped`, `external`, `variable`.
- `virtual` (`boolean`, optional): Set to true for a virtual product that is not shipped.
- `weight` (`string`, optional): Weight in the store's weight unit, as a string. Example: 0.5.

Example input: `{"product_id":794}`

## Related

Other CRM & Sales connectors ([all 174](/agentkit/connectors/?category=crm-sales)):

- [Salesforce](/agentkit/connectors/salesforce/): Scalekit connector, OAuth, 74 tools
- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Close](/agentkit/connectors/close/): Scalekit connector, OAuth, 103 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
