Redeem coupon
Attach a coupon to an account before or after a subscription.
POST https://cotlet.dev/api/v1/recurly/accounts/{account_code}/coupons/{coupon_code}/redeem
write Confirm
Redeems a coupon code for one account. Recurly holds the redemption on the account and applies it at the next subscription creation, change or renewal, so it changes what the customer pays. Returns the total discounted so far and the currency. A wrong code or currency fails with a validation error. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| account_code string required | string | Account code from list_accounts. |
| coupon_code string required | string | Coupon code as created in Recurly. |
| currency string | string | Currency of the redemption, for example USD. |
Request
curl -X POST https://cotlet.dev/api/v1/recurly/accounts/account%20code/coupons/coupon%20code/redeem \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("recurly", "redeem_coupon", {"account_code":"account code","coupon_code":"coupon code"})const result = await cotlet.call('recurly', 'redeem_coupon', {"account_code":"account code","coupon_code":"coupon code"});cotlet call recurly redeem_coupon --data '{"account_code":"account code","coupon_code":"coupon code"}'Example response
{
"account_code": "north-yard",
"coupon_code": "WINBACK20",
"currency": "USD",
"total_discounted_in_cents": 0,
"created_at": "2026-10-14T10:31:00Z"
}