woocommerce
WooCommerce REST API - products, orders, customers, webhooks
By alinaqi · 380 installs
npx skills add alinaqi/maggy --skill woocommerce
Source repository · Upstream listing
WooCommerce Development Skill
For integrating with WooCommerce stores via REST API products, orders, customers, webhooks, and custom extensions.
Sources: [WooCommerce REST API](https://woocommerce.github.io/woocommerce rest api docs/) [Developer Docs](https://developer.woocommerce.com/docs/)
Prerequisites
Store Requirements
Generate API Keys
1. Go to WooCommerce → Settings → Advanced → REST API
2. Click Add key
3. Set Description, User (admin), and Permissions (Read/Write)
4. Click Generate API key
5. Copy Consumer Key and Consumer Secret (shown only once)
API Basics
Base URL
Authentication
Query String Auth (Fallback)
Installation
Node.js
Python
Products
List Products
Get Single Product
Create Product
Update Product
Delete Product
Variable Products
Orders
List Orders
Get Single Order
Create Order
Update Order Status
Order Statuses
Status Description
pending Awaiting payment
processing Payment received, awaiting fulfillment
on hold Awaiting action (stock, payment confirmation)
completed Order fulfilled
cancelled Cancelled by admin or customer
refunded Refunded
failed Payment failed
Customers
List Customers
Create Customer
Update Customer
Webhooks
Create Webhook
Webhook Topics
Topic Trigger
order.created New order placed
order.updated Order status/details changed
order.deleted Order deleted
product.created New product created
product.updated Product updated
product.deleted Product deleted
customer.created New customer registered
customer.updated Customer updated
coupon.created New coupon created
Verify Webhook Signature
Categories & Tags
List Categories
List Tags
Coupons
Create Coupon
Reports
Sales Report
Pagination
Handle Large Datasets
Pagination Headers
Header Description
X WP Total Total number of items
X WP TotalPages Total number of pages
Error Handling
Environment Variables
Add to credentials.md :
Checklist
Before Integration
[ ] WooCommerce plugin installed and activated
[ ] HTTPS enabled on store
[ ] Permalinks set to non Plain setting
[ ] API keys generated with appropriate permissions
[ ] Webhook secret configured
Security
[ ] API keys stored in environment variables
[ ] Webhook signatures verified
[ ] HTTPS used for all API calls
[ ] Rate limiting handled
Testing
[ ] Test API connection
[ ] Test product CRUD operations
[ ] Test order creation/updates
[ ] Test webhook delivery
[ ] Test pagination for large datasets
Anti Patterns
Plain permalinks API won't work without pretty permalinks
HTTP in production Always use HTTPS
Ignoring rate limits WooCommerce may throttle requests
Large single requests Use pagination for bulk operations
Storing keys in code Use environment variables
Skipping webhook verification Always verify signatures