Create a coupon
create_couponCreates a coupon for buying packs. kind: percent (value = % off), amount (value_eur off), extra (value = free classes added), bonus (value = % more classes, same price and expiry: 30 turns 10 classes into 13; 100 = 1+1, double). Free classes do not apply to unlimited packs. Without code it applies automatically to the members it is for; with code the member types it when buying. Acts on one venue, given its address and access key.
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": {
"address": "<address>",
"access_key": "<access_key>",
"name": "<name>",
"kind": "<kind>"
},
"name": "create_coupon"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | Optional code, 3-30 Latin letters, digits or dashes. Leave out for an automatic coupon. | |
| from | No | Optional first day, YYYY-MM-DD. | |
| kind | Yes | ||
| name | Yes | Shown to members next to the price, e.g. "New Year". | |
| until | No | Optional last day, YYYY-MM-DD. | |
| value | No | percent: 1-100; extra: 1-100 classes; bonus: 1-500 (% more classes, 100 = 1+1). Not for amount. | |
| address | Yes | The venue’s address name, the "name" in name.bookare.app. | |
| max_uses | No | Total uses. Leave out for no limit. | |
| pack_ids | No | Only for these packs (pack ids). Leave out for all packs. | |
| group_ids | No | ||
| value_eur | No | Only for kind amount, e.g. 10. | |
| access_key | Yes | The venue’s access key. | |
| member_ids | No | Only for these members (with group_ids). Leave both out for all members. | |
| per_member | No | Uses per member, 0 = no limit. Default 1. |