Skip to main content
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

​
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.
Supported discount types:
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.

​
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.
All list-* abilities accept orderby, order, per_page, and page. See listing conventions for the full reference.