Buttondown logo

Introduction

Coupons let you offer discounts to subscribers who pay for your newsletter. Buttondown's coupons are backed by Stripe, so each coupon maps to a coupon on your connected Stripe account. Use them to run promotions—for example, a percentage off a paid subscription.

{
    "coupon_id": "coupon_whatever",
    "percent_off": "10",
    "amount_off": null,
    "name": "Holiday Sale"
}

Fields

coupon_id

Type
string
Description

The Stripe coupon ID (e.g. coupon_...).

percent_off

Type
string
Description

The percentage discount applied by the coupon, if any.

amount_off

Type
integer
Description

The fixed amount discount applied by the coupon, in the smallest currency unit (e.g. cents), if any.

name

Type
string
Description

The display name of the coupon.