Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.maxicore.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

AbilityDescriptionCapabilityPlan
maxi/create-couponCreate a coupon with discount type, amount, limits, and restrictions.manage_woocommercePro
maxi/get-couponGet coupon details by ID or coupon code, including usage stats.manage_woocommercePro
maxi/update-couponUpdate coupon amount, expiry, limits, or restrictions. Send only fields to change.manage_woocommercePro
maxi/delete-couponDelete a coupon permanently.manage_woocommercePro
maxi/list-couponsList coupons with optional filters.manage_woocommercePro

​
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
}
Supported discount types:
TypeBehavior
percentPercentage off the cart or product total
fixed_cartFixed amount off the entire cart
fixed_productFixed 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). 
{ "code": "SUMMER20" }

​
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.