Apply promo code
apply_promo_codeApply a promo / discount code to an existing order. Promo codes can only be applied to orders still in DRAFT or SCHEDULED state — before pickup. Requires order code, email, and the promo code (typically 4–12 alphanumeric, e.g. "WELCOME10" or "REF-AB12"). Returns the new total and the discount applied.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"orderCode": "<orderCode>",
"promoCode": "<promoCode>"
},
"name": "apply_promo_code"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| No | Email used when scheduling. Not needed when the customer has connected their Fold account. | ||
| orderCode | Yes | Order code (FHL-XXXXXX or FOLD-XXXXX). | |
| promoCode | Yes | Promo code (case-insensitive), e.g. "WELCOME10". |