Coupon abilities let your AI agent manage the full lifecycle of WooCommerce discount coupons — creating percentage or fixed-amount codes, setting expiry dates and usage limits, updating live coupons, and reviewing current usage counts. All coupon abilities require an active Pro plan, WooCommerce to be installed and active, and the manage_woocommerce capability on the connected WordPress user.
All WooCommerce coupon abilities require WooCommerce to be active and a Pro plan license. The connected WordPress user must have the manage_woocommerce capability — typically assigned to the Shop Manager or Administrator role.
All coupon abilities
| Ability | Description | Capability | Plan |
|---|
maxi/create-coupon | Create a coupon with discount type, amount, limits, and restrictions. | manage_woocommerce | Pro |
maxi/get-coupon | Get coupon details by ID or coupon code, including usage stats. | manage_woocommerce | Pro |
maxi/update-coupon | Update coupon amount, expiry, limits, or restrictions. Send only fields to change. | manage_woocommerce | Pro |
maxi/delete-coupon | Delete a coupon permanently. | manage_woocommerce | Pro |
maxi/list-coupons | List coupons with optional filters. | manage_woocommerce | Pro |
Key ability examples
maxi/create-coupon
Create a new discount coupon. Choose from three discount types, set an optional expiry date, and cap total usage or usage per customer.
{
"code": "SUMMER20",
"discount_type": "percent",
"amount": "20",
"expiry_date": "2025-08-31",
"usage_limit": 100
}
| Type | Behavior |
|---|
percent | Percentage off the cart or product total |
fixed_cart | Fixed amount off the entire cart |
fixed_product | Fixed amount off each qualifying product |
Coupon codes are case-insensitive in WooCommerce. The code you pass in create-coupon is stored as-is, but customers can enter it in any case at checkout.
maxi/get-coupon
Retrieve a coupon by its numeric ID or by its coupon code. The response includes usage statistics — how many times the coupon has been used (usage_count) and the list of customer user IDs or email addresses who used it (used_by).
maxi/update-coupon
Update any coupon field. Send only the fields you want to change — omitted fields remain untouched.
{
"coupon_id": 789,
"amount": "25",
"expiry_date": "2025-09-30"
}
maxi/delete-coupon
Delete a coupon permanently by its numeric ID. This cannot be undone.
maxi/delete-coupon removes the coupon and all associated data permanently. If you want to prevent further use without losing the record, update the coupon’s expiry_date to a past date or set usage_limit to match the current usage_count instead of deleting.
maxi/list-coupons
List all coupons on your store, with optional filters and pagination.
{ "per_page": 20, "page": 1 }
All list-* abilities accept orderby, order, per_page, and page. See listing conventions for the full reference. 
