1. Docs
2. /
3. Tool reference
4. /
5. Commerce
6. /
7. updateCoupon

Commerce

updateCoupon

Update Coupon

Change what an existing coupon is worth or who may redeem it: value, minimum cart, the bigger minimum that applies from a customer's second redemption onward (minSubtotalAfterFirstMinor), window,…

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "make SAVE5 ten dollars instead", and it calls updateCoupon.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "appId": "<appId>",
    "couponId": "<couponId>"
  },
  "name": "updateCoupon"
}

Arguments

• appIdstringrequiredThe Studio app ID whose shop owns the coupon.
• couponIdstringrequiredThe coupon ID (from listCoupons).
• statusstringoptionalactive redeems; paused stops new redemptions reversibly; archived retires it.
• valuenumberoptionalNew value in the coupon's own kind: minor units for a flat code, whole percent for a percent one.
• endsAtnumberoptionalEpoch ms the code stops working. Omit for no expiry.
• firstOrderOnlybooleanoptionalRedeemable only by someone with no paid order at this shop yet. Same identity caveat as perCustomerLimit.
• maxRedemptionsintegeroptionalTotal redemptions across all buyers, ever. This is the HARD bound: it holds even for an anonymous checkout with no email. Omit for unlimited.
• minSubtotalAfterFirstMinorintegeroptionalSmallest cart from the customer's second redemption onward, in minor units; the first redemption has no such floor. Counted per email, like perCustomerLimit.
• minSubtotalMinorintegeroptionalSmallest cart the code works on, in minor units (2000 = a $20 cart). Omit for no minimum.
• perCustomerLimitintegeroptionalRedemptions allowed per buyer. Counted per email, so it only bites where a buyer identity is known before payment; maxRedemptions is what always holds.
• startsAtnumberoptionalEpoch ms the code starts working. Omit to start immediately.

Returns

The registry does not declare a return shape.

Declared limits

• value: greater than 0
• maxRedemptions: greater than 0
• maxRedemptions: maximum 9007199254740991
• minSubtotalAfterFirstMinor: minimum 0
• minSubtotalAfterFirstMinor: maximum 9007199254740991
• minSubtotalMinor: minimum 0
• minSubtotalMinor: maximum 9007199254740991
• perCustomerLimit: greater than 0
• perCustomerLimit: maximum 9007199254740991

Ask for it

The Cloud routes these requests to this verb.

• make SAVE5 ten dollars instead
• give that code an expiry
• limit it to one per customer
• make the second use need a $45 order
• turn that coupon back on

Pair it with

The verbs that finish the job.

• listCoupons

Questions

• What does updateCoupon do?

  Change what an existing coupon is worth or who may redeem it: value, minimum cart, the bigger minimum that applies from a customer's second redemption onward (minSubtotalAfterFirstMinor), window,… It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use updateCoupon from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "make SAVE5 ten dollars instead", and it calls updateCoupon.

• Is updateCoupon safe to let an AI call?

  updateCoupon changes your workspace. What an AI creates is Private until you share it.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.