Overview
WooCommerce is the e-commerce platform built on WordPress – open source, self-hosted, very common for SMBs. The Automize WooCommerce connector covers products, orders, customers, coupons, categories, and sales reports via the WooCommerce REST API.
- Regions: Self-hosted on the customer's own server. Each store has its own domain. Connector hits the store URL directly.
- Plans: Free core. Premium extensions add functionality. API access is available on all installs (no plan gate).
Setting up the connection
Auth type: oauth1.
- In WordPress admin → WooCommerce → Settings → Advanced → REST API → Add key.
- Pick user, set permissions (Read/Write), generate.
- Copy Consumer Key + Consumer Secret.
- In Automize, open Settings → Connectors → WooCommerce → Add connection. Enter store URL + Consumer Key + Consumer Secret.
Find your credentials at https://yourstore.com/wp-admin/admin.php?page=wc-settings&tab=advanced§ion=keys.
Rate limits
WooCommerce itself doesn't rate-limit (it's self-hosted). Performance is bounded by the underlying server. For high-volume use, the store owner should consider caching plugins and a beefier host.
Data model
WordPress + WooCommerce:
Store ─┬─ Products ─── Variations (for variable products)
├─ Categories ─── (hierarchical)
├─ Orders ─── Line Items ─── (each tied to a Product)
├─ Customers ─── Addresses (billing + shipping)
└─ Coupons
Authentication is OAuth 1.0a over HTTPS (or basic auth – pass keys as
query params over HTTPS for some hosting).Available operations
13 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Create Product | General | Create a new product |
| Delete Product | General | Delete a product |
| Get Customer | General | Get customer details |
| Get Order | General | Get order details |
| Get Product | General | Get product details |
| Get Sales Report | General | Get sales report summary |
| List Categories | General | List product categories |
| List Coupons | General | List all coupons |
| List Customers | General | List all customers |
| List Orders | General | List all orders |
| List Products | General | List all products |
| Update Order | General | Update an existing order |
| Update Product | General | Update an existing product |
Operations
Create Product
Create a new product
| Parameter | Required | Type | Description |
|---|---|---|---|
Name name | Yes | text | |
Type type | Yes | text | |
Regular Price regular_price | Yes | text | |
Description description | Yes | text | |
Short Description short_description | Yes | text | |
Categories categories | Yes | text | |
Images images | Yes | text |
Tips
- name + type (simple, variable, grouped, external) + regular_price.
- categories: [{id: X}, ...]. images: [{src: 'https://...'}].
Delete Product
Delete a product
| Parameter | Required | Type | Description |
|---|---|---|---|
Product Id product_id | Yes | text |
Tips
- Hard-delete (force=true) or move to trash (default).
Get Customer
Get customer details
| Parameter | Required | Type | Description |
|---|---|---|---|
Customer Id customer_id | Yes | text |
Tips
- Returns customer + addresses + total_spent + orders_count.
Get Order
Get order details
| Parameter | Required | Type | Description |
|---|---|---|---|
Order Id order_id | Yes | text |
Tips
- Returns order + line_items + customer + billing + shipping.
Get Product
Get product details
| Parameter | Required | Type | Description |
|---|---|---|---|
Product Id product_id | Yes | text |
Tips
- Returns product + variations references.
Get Sales Report
Get sales report summary
No input parameters.
Tips
- Filter by period (week, month, last_month, year) OR date_min / date_max.
- Returns aggregated totals – useful for dashboards.
List Categories
List product categories
No input parameters.
Tips
- Hierarchical via parent + slug.
List Coupons
List all coupons
No input parameters.
Tips
- Filter by code (exact match).
List Customers
List all customers
No input parameters.
Tips
- Filter by email, role (customer, subscriber).
List Orders
List all orders
No input parameters.
Tips
- Filter by status (pending, processing, on-hold, completed, cancelled, refunded, failed).
- Date filters: after, before (ISO format).
List Products
List all products
No input parameters.
Tips
- Page via per_page (max 100) + page.
- Filter: status (publish, draft, private), category, tag, sku.
Update Order
Update an existing order
| Parameter | Required | Type | Description |
|---|---|---|---|
Order Id order_id | Yes | text |
Tips
- Most common: status='completed' to mark fulfilled. customer_note for customer-visible note.
Update Product
Update an existing product
| Parameter | Required | Type | Description |
|---|---|---|---|
Product Id product_id | Yes | text |
Tips
- PUT-style. status='publish' to go live.
FAQ
- Why does my API call return 401?
- Most likely HTTPS not enforced or OAuth signature mismatch. WooCommerce REST API requires HTTPS for OAuth 1 to work properly. For plain HTTP, use the legacy auth method (not recommended).
- Variable products – how?
- Create the parent with type='variable'. Add attributes (size, color) via Update Product. Then create variations via Create Variation (not exposed in this connector – needs Update Product with variations[]).
- Sandbox / staging?
- WooCommerce is self-hosted – set up a separate staging install (e.g. staging.yourstore.com) with its own keys. Create a separate Automize connection.
- WooCommerce v3 API vs other?
- Connector uses v3 (wc/v3 namespace). v2 is deprecated.