Skip to main content
POST
/
promo_codes
JavaScript
import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
});

const promoCode = await client.promoCodes.create({
  amount_off: 6.9,
  base_currency: 'usd',
  code: 'code',
  company_id: 'biz_xxxxxxxxxxxxxx',
  new_users_only: true,
  promo_duration_months: 42,
  promo_type: 'percentage',
});

console.log(promoCode.id);
{
  "id": "promo_xxxxxxxxxxxx",
  "amount_off": 6.9,
  "currency": "usd",
  "churned_users_only": true,
  "code": "<string>",
  "created_at": "2023-12-01T05:00:00.401Z",
  "existing_memberships_only": true,
  "duration": "forever",
  "expires_at": "2023-12-01T05:00:00.401Z",
  "new_users_only": true,
  "promo_duration_months": 42,
  "one_per_customer": true,
  "product": {
    "id": "prod_xxxxxxxxxxxxx",
    "title": "Pickaxe Analytics"
  },
  "promo_type": "percentage",
  "status": "active",
  "stock": 42,
  "unlimited_stock": true,
  "uses": 42,
  "company": {
    "id": "biz_xxxxxxxxxxxxxx",
    "title": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************

Body

application/json

Parameters for CreatePromoCode

​
amount_off
number
required

The discount amount. When promo_type is percentage, this is the percent off (e.g., 20 for 20% off). When promo_type is flat_amount, this is the currency amount off (e.g., 10.00 for $10.00 off).

Example:

6.9

​
base_currency
enum<string>
required

The three-letter ISO currency code for the promo code discount.

Available options:
usd,
sgd,
inr,
aud,
brl,
cad,
dkk,
eur,
nok,
gbp,
sek,
chf,
hkd,
huf,
jpy,
mxn,
myr,
pln,
czk,
nzd,
aed,
eth,
ape,
cop,
ron,
thb,
bgn,
idr,
dop,
php,
try,
krw,
twd,
vnd,
pkr,
clp,
uyu,
ars,
zar,
dzd,
tnd,
mad,
kes,
kwd,
jod,
all,
xcd,
amd,
bsd,
bhd,
bob,
bam,
khr,
crc,
xof,
egp,
etb,
gmd,
ghs,
gtq,
gyd,
ils,
jmd,
mop,
mga,
mur,
mdl,
mnt,
nad,
ngn,
mkd,
omr,
pyg,
pen,
qar,
rwf,
sar,
rsd,
lkr,
tzs,
ttd,
uzs,
rub,
btc,
cny,
usdt
​
code
string
required

The alphanumeric code customers enter at checkout to apply the discount.

​
company_id
string
required

The unique identifier of the company to create this promo code for.

Example:

"biz_xxxxxxxxxxxxxx"

​
new_users_only
boolean
required

Whether to restrict this promo code to only users who have never purchased from the company before.

​
promo_duration_months
integer
required

The number of billing months the discount remains active. For example, 3 means the discount applies to the first 3 billing cycles.

Example:

42

​
promo_type
enum<string>
required

The discount type, either percentage or flat_amount.

Available options:
percentage,
flat_amount
​
churned_users_only
boolean | null

Whether to restrict this promo code to only users who have previously churned from the company.

​
existing_memberships_only
boolean | null

Whether this promo code can only be applied to existing memberships, such as for cancellation retention offers.

​
expires_at
string<date-time> | null

The datetime when the promo code expires and can no longer be used. Null means it never expires.

Example:

"2023-12-01T05:00:00.401Z"

​
one_per_customer
boolean | null

Whether each customer can only use this promo code once.

​
plan_ids
string[] | null

The identifiers of plans this promo code applies to. When product_id is also provided, only plans attached to that product are included.

Represents a unique identifier that is Base64 obfuscated. It is often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "VXNlci0xMA==") or integer (such as 4) input value will be accepted as an ID.

​
product_id
string | null

The identifier of the product to scope this promo code to. When provided, the promo code only applies to plans attached to this product.

Example:

"prod_xxxxxxxxxxxxx"

​
stock
integer | null

The maximum number of times this promo code can be used. Ignored when unlimited_stock is true.

Example:

42

​
unlimited_stock
boolean | null

Whether the promo code can be used an unlimited number of times.

Response

A successful response

A promo code applies a discount to a plan during checkout. Promo codes can be percentage-based or fixed-amount, and can have usage limits and expiration dates.

​
id
string
required

The unique identifier for the promo code.

Example:

"promo_xxxxxxxxxxxx"

​
amount_off
number
required

The discount amount. Interpretation depends on promo_type: if 'percentage', this is the percentage (e.g., 20 means 20% off); if 'flat_amount', this is dollars off (e.g., 10.00 means $10.00 off).

Example:

6.9

​
currency
enum<string>
required

The monetary currency of the promo code.

Available options:
usd,
sgd,
inr,
aud,
brl,
cad,
dkk,
eur,
nok,
gbp,
sek,
chf,
hkd,
huf,
jpy,
mxn,
myr,
pln,
czk,
nzd,
aed,
eth,
ape,
cop,
ron,
thb,
bgn,
idr,
dop,
php,
try,
krw,
twd,
vnd,
pkr,
clp,
uyu,
ars,
zar,
dzd,
tnd,
mad,
kes,
kwd,
jod,
all,
xcd,
amd,
bsd,
bhd,
bob,
bam,
khr,
crc,
xof,
egp,
etb,
gmd,
ghs,
gtq,
gyd,
ils,
jmd,
mop,
mga,
mur,
mdl,
mnt,
nad,
ngn,
mkd,
omr,
pyg,
pen,
qar,
rwf,
sar,
rsd,
lkr,
tzs,
ttd,
uzs,
rub,
btc,
cny,
usdt
​
churned_users_only
boolean
required

Restricts promo use to only users who have churned from the company before.

​
code
string | null
required

The specific code used to apply the promo at checkout.

​
created_at
string<date-time>
required

The datetime the promo code was created.

Example:

"2023-12-01T05:00:00.401Z"

​
existing_memberships_only
boolean
required

Restricts promo use to only be applied to already purchased memberships.

​
duration
enum<string> | null
required

The duration of the promo.

Available options:
forever,
once,
repeating
​
expires_at
string<date-time> | null
required

The date/time of when the promo expires.

Example:

"2023-12-01T05:00:00.401Z"

​
new_users_only
boolean
required

Restricts promo use to only users who have never purchased from the company before.

​
promo_duration_months
integer | null
required

The number of months the promo is applied for.

Example:

42

​
one_per_customer
boolean
required

Restricts promo use to only be applied once per customer.

​
product
object
required

The product this promo code applies to

​
promo_type
enum<string>
required

The type (% or flat amount) of the promo.

Available options:
percentage,
flat_amount
​
status
enum<string>
required

Indicates if the promo code is live or disabled.

Available options:
active,
inactive,
archived
​
stock
integer
required

The quantity limit on the number of uses.

Example:

42

​
unlimited_stock
boolean
required

Whether or not the promo code has unlimited stock.

​
uses
integer
required

The amount of times the promo codes has been used.

Example:

42

​
company
object
required

The company for the promo code.