Manage LINE OA coupons
line_manage_couponManage LINE OA coupons by creating them with discount types (percentage, fixed, or explicit), automatic date conversion, and visibility options, then list, get details, or permanently discontinue a coupon.
Instructions
Coupon CRUD on a LINE OA (POST /v2/bot/coupon). modes: create (maps friendly inputs to LINE's schema — dates to UNIX seconds, visibility, etc.), list, get (by coupon_id), discontinue (ends a live coupon; irreversible — requires confirm=true). Deliver a created coupon via line_send_message message.coupon_id. Rate limit: shared 200 req/sec bucket with multicast.
create data: title (≤60, required); discount_type 'percentage'(default)|'fixed'|'explicit' with discount_value (or price_before/price_after for explicit); valid_from/valid_to accept UNIX seconds | 'YYYY-MM-DD' | ISO; visibility PUBLIC|UNLISTED (default UNLISTED); acquisition_type normal|lottery.
Example: "Early Bird ลด 20% 1–8 มิ.ย." → { mode:"create", data:{ title:"Early Bird", discount_type:"percentage", discount_value:20, valid_from:"2026-06-01", valid_to:"2026-06-08", coupon_code:"EARLYBIRD" } }. "ปิด coupon C123" → { mode:"discontinue", coupon_id:"C123", confirm:true }.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| oa | No | ||
| data | No | Required for mode='create'. | |
| mode | Yes | create: make a new coupon; list: list all coupons; get: fetch one; discontinue: end one (irreversible). | |
| confirm | No | Required true for mode='discontinue'. | |
| coupon_id | No | Required for mode='get' or 'discontinue'. | |
| response_format | No | markdown |