Skip to main content
PATCH
/
plans
/
{id}
JavaScript
import Whop from '@whop/sdk';

const client = new Whop({
  apiKey: 'My API Key',
});

const plan = await client.plans.update('plan_xxxxxxxxxxxxx');

console.log(plan.id);
{
  "id": "plan_xxxxxxxxxxxxx",
  "created_at": "2023-12-01T05:00:00.401Z",
  "updated_at": "2023-12-01T05:00:00.401Z",
  "visibility": "visible",
  "plan_type": "renewal",
  "release_method": "buy_now",
  "currency": "usd",
  "company": {
    "id": "biz_xxxxxxxxxxxxxx",
    "title": "<string>"
  },
  "product": {
    "id": "prod_xxxxxxxxxxxxx",
    "title": "<string>"
  },
  "invoice": {
    "id": "inv_xxxxxxxxxxxxxx"
  },
  "billing_period": 42,
  "title": "<string>",
  "description": "<string>",
  "purchase_url": "<string>",
  "expiration_days": 42,
  "initial_price": 6.9,
  "renewal_price": 6.9,
  "trial_period_days": 42,
  "member_count": 42,
  "internal_notes": "<string>",
  "stock": 42,
  "unlimited_stock": true,
  "split_pay_required_payments": 42,
  "payment_method_configuration": {
    "enabled": [
      "acss_debit"
    ],
    "disabled": [
      "acss_debit"
    ],
    "include_platform_defaults": true
  },
  "tax_type": "inclusive",
  "collect_tax": true,
  "custom_fields": [
    {
      "id": "field_xxxxxxxxxxxx",
      "field_type": "<string>",
      "name": "<string>",
      "order": 42,
      "placeholder": "<string>",
      "required": true
    }
  ]
}

Authorizations

​
Authorization
string
header
required

The app API key from an app from the /dashboard/developer page

Path Parameters

​
id
string
required

The ID

Example:

"plan_xxxxxxxxxxxxx"

Body

application/json

Parameters for UpdatePlan

​
billing_period
integer | null

The interval at which the plan charges (renewal plans).

Example:

42

​
currency
enum<string> | null

The respective currency identifier for the plan.

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
​
custom_fields
object[] | null

An array of custom field objects.

​
description
string | null

The description of the plan.

​
expiration_days
integer | null

The interval at which the plan charges (expiration plans).

Example:

42

​
image
AttachmentInputWithDirectUploadId · object

An image for the plan. This will be visible on the product page to customers. Input for an attachment

  • AttachmentInputWithDirectUploadId
  • AttachmentInputWithId
​
initial_price
number | null

An additional amount charged upon first purchase.

Example:

6.9

​
internal_notes
string | null

A personal description or notes section for the business.

​
offer_cancel_discount
boolean | null

Whether or not to offer a discount to cancel a subscription.

​
override_tax_type
enum<string> | null

An override for tax to specify for this specific plan.

Available options:
inclusive,
exclusive,
unspecified
​
payment_method_configuration
object

The explicit payment method configuration for the plan. If sent as null, the custom configuration will be removed.

​
renewal_price
number | null

The amount the customer is charged every billing period.

Example:

6.9

​
stock
integer | null

The number of units available for purchase.

Example:

42

​
strike_through_initial_price
number | null

The price to display with a strikethrough for the initial price. Provided as a number in dollars. Eg: 19.99 for $19.99

Example:

6.9

​
strike_through_renewal_price
number | null

The price to display with a strikethrough for the renewal price. Provided as a number in dollars. Eg: 19.99 for $19.99

Example:

6.9

​
title
string | null

The title of the plan. This will be visible on the product page to customers.

​
trial_period_days
integer | null

The number of free trial days added before a renewal plan.

Example:

42

​
unlimited_stock
boolean | null

Limits/doesn't limit the number of units available for purchase.

​
visibility
enum<string> | null

Shows or hides the plan from public/business view.

Available options:
visible,
hidden,
archived,
quick_link

Response

A successful response

A plan for an product. Plans define the core parameters that define a checkout and payment on whop. Use plans to create different ways to price your products (Eg renewal / one_time)

​
id
string
required

The internal ID of the plan.

Example:

"plan_xxxxxxxxxxxxx"

​
created_at
string<date-time>
required

When the plan was created.

Example:

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

​
updated_at
string<date-time>
required

When the plan was last updated.

Example:

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

​
visibility
enum<string>
required

Shows or hides the plan from public/business view.

Available options:
visible,
hidden,
archived,
quick_link
​
plan_type
enum<string>
required

Indicates if the plan is a one time payment or recurring.

Available options:
renewal,
one_time
​
release_method
enum<string>
required

This is the release method the business uses to sell this plan.

Available options:
buy_now,
waitlist
​
currency
enum<string>
required

The respective currency identifier for the plan.

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
​
company
object
required

The company for the plan.

​
product
object
required

The product that this plan belongs to.

​
invoice
object
required

The invoice associated with this plan.

​
billing_period
integer | null
required

The interval at which the plan charges (renewal plans).

Example:

42

​
title
string | null
required

The title of the plan. This will be visible on the product page to customers.

​
description
string | null
required

The description of the plan.

​
purchase_url
string
required

The direct link to purchase the product.

​
expiration_days
integer | null
required

The interval at which the plan charges (expiration plans).

Example:

42

​
initial_price
number
required

The price a person has to pay for a plan on the initial purchase.

Example:

6.9

​
renewal_price
number
required

The price a person has to pay for a plan on the renewal purchase.

Example:

6.9

​
trial_period_days
integer | null
required

The number of free trial days added before a renewal plan.

Example:

42

​
member_count
integer | null
required

The number of members for the plan.

Example:

42

​
internal_notes
string | null
required

A personal description or notes section for the business.

​
stock
integer | null
required

The number of units available for purchase. Only displayed to authorized actors

Example:

42

​
unlimited_stock
boolean
required

Limits/doesn't limit the number of units available for purchase.

​
split_pay_required_payments
integer | null
required

The number of payments required before pausing the subscription.

Example:

42

​
payment_method_configuration
object
required

The explicit payment method configuration for the plan, if any.

​
tax_type
enum<string>
required

The tax type for the plan.

Available options:
inclusive,
exclusive,
unspecified
​
collect_tax
boolean
required

Whether or not the plan collects tax.

​
custom_fields
object[]
required

The custom fields for the plan.