Sign in
latestOpenAPI 3.1.02026-08-153864115.7 MB

c301132dbfd7

Plans

Update Plan

Update a plan's pricing, billing interval, visibility, stock, and other settings.

patch/plans/{id}

Request body

adaptive_pricing_enabledboolean nullable

Whether this plan accepts local currency payments via adaptive pricing.

billing_periodinteger nullable

Recurring billing interval in days, such as 30 for monthly or 365 for annual.

cancel_discount_intervalsinteger nullable

How many renewals the retention discount applies to. Required when offer_cancel_discount is true.

cancel_discount_percentageinteger nullable

Percentage taken off each discounted renewal. Required when offer_cancel_discount is true.

checkout_stylingobject nullable

Checkout styling overrides for this plan.

currencystring

The three-letter ISO currency code for the plan's pricing. Defaults to USD.

descriptionstring nullable

A text description of the plan displayed to customers on the product page.

expiration_daysinteger nullable

Access duration in days before the membership expires.

initial_pricenumber nullable

Initial amount charged in the plan's currency, e.g. 10.43 for $10.43.

internal_notesstring nullable

Private notes visible only to the account owner. Not shown to customers.

metadataobject nullable

Custom key-value pairs to store on the plan. Included in webhook payloads for payment and membership events. Max 50 keys, 100 chars per key, 500 chars per string value.

offer_cancel_discountboolean nullable

Whether to offer a retention discount when a customer attempts to cancel.

override_tax_typestring

Override the default tax classification for this specific plan.

release_methodstring

Sales method for this plan.

renewal_pricenumber nullable

The amount charged each billing period for recurring plans, in the plan's currency.

stockinteger nullable

The maximum number of units available for purchase. Ignored when unlimited_stock is true.

strike_through_initial_pricenumber nullable

A comparison price displayed with a strikethrough for the initial price.

strike_through_renewal_pricenumber nullable

A comparison price displayed with a strikethrough for the renewal price.

three_ds_level'mandate_challenge' | 'frictionless' nullable

3D Secure behavior for this plan. Send null to inherit the account default.

titlestring nullable

The display name of the plan shown to customers on the product page.

trial_period_daysinteger nullable

Free trial duration before the first recurring charge.

unlimited_stockboolean nullable

Whether the plan has unlimited stock. When true, the stock field is ignored.

visibilitystring

Whether the plan is visible to customers or hidden from public view.

Example request

{
  "adaptive_pricing_enabled": true,
  "billing_period": 30,
  "cancel_discount_intervals": 3,
  "cancel_discount_percentage": 20,
  "checkout_styling": {
    "background_color": "#0f172a",
    "border_style": "rounded",
    "button_color": "#f59e0b",
    "font_family": "roboto"
  },
  "currency": "usd",
  "custom_fields": [
    {
      "field_type": "text",
      "id": "field_xxxxxxxxxxxxxx",
      "name": "Vehicle make and model",
      "order": 1,
      "placeholder": "2021 Audi S5",
      "required": true
    }
  ],
  "description": "Two hand washes a month, interior vacuum, and a quarterly sealant top-up.",
  "expiration_days": 365,
  "image": {
    "direct_upload_id": "eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "id": "file_xxxxxxxxxxxxxx"
  },
  "internal_notes": "Maintenance tier. Upsell the interior shampoo add-on at renewal.",
  "metadata": {
    "bay": "2",
    "route": "north-austin"
  },
  "offer_cancel_discount": true,
  "override_tax_type": "inclusive",
  "payment_method_configuration": {
    "disabled": [
      "paypal"
    ],
    "enabled": [
      "card"
    ],
    "include_platform_defaults": true
  },
  "release_method": "buy_now",
  "renewal_price": 59,
  "stock": 25,
  "strike_through_initial_price": 99,
  "strike_through_renewal_price": 79,
  "three_ds_level": "frictionless",
  "title": "Unlimited Wash Club",
  "trial_period_days": 7,
  "visibility": "visible"
}

Response

plan updated

accountobject nullable required

Account that sells this plan; null for standalone invoice plans.

adaptive_pricing_enabledboolean required

Whether adaptive pricing is enabled for this plan. Raw setting — does not check processor compatibility or feature flags.

billing_periodnumber nullable required

Number of days between recurring charges, such as 30 for monthly or 365 for annual. null for one-time plans.

cancel_discount_intervalsnumber nullable required

Billing intervals the cancellation discount applies to (0 forever, 1 first payment, or a month count). null when none is offered or the actor lacks the plan:basic:read scope.

cancel_discount_percentagenumber nullable required

Cancellation discount as a whole-number percentage. null when none is offered or the actor lacks the plan:basic:read scope.

checkout_stylingobject nullable required

Plan-level checkout styling (background_color, button_color, font_family, border_style); null inherits the account default.

collect_taxboolean required

Whether tax is collected on purchases of this plan, based on the account's tax configuration.

created_atstring required

When the plan was created, as an ISO 8601 timestamp.

currency'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' | 'kzt' | 'awg' | 'whop_usd' | 'xau' required

Three-letter ISO currency code for this plan's prices.

deletableboolean nullable required

Whether the plan can be deleted (it has no memberships or waitlist entries). null unless the actor has the plan:basic:read scope on the plan's account.

descriptionstring nullable required

Customer-visible plan description. Maximum 1000 characters. null if no description is set.

expiration_daysnumber nullable required

Access duration in days for expiration-based plans, such as 365 for a one-year pass. null for plans without an expiration.

formatted_pricestring required

Human-readable price for display (currency + interval), e.g. "$10 / month".

idstring required

Plan ID, prefixed plan_.

imageobject nullable required

Pricing-tier image (url, blurhash) shown on the product page; null when no image is set.

initial_pricenumber required

Initial purchase price in plan currency.

internal_notesstring nullable required

Private notes not shown to customers. null unless the actor has the plan:basic:read scope on the plan's account.

invoiceobject nullable required

Invoice this plan was generated for; null unless created for an invoice.

member_countnumber nullable required

Active memberships through this plan. null unless the actor has the plan:basic:read scope on the plan's account.

metadataobject nullable required

Custom key-value pairs stored on the plan. Included in webhook payloads for payment and membership events. Maximum 50 keys, 100 characters per key, 500 characters per value.

offer_cancel_discountboolean nullable required

Whether a cancellation discount is offered. null unless the actor has the plan:basic:read scope on the plan's account.

payment_method_configurationobject nullable required

Payment method configuration (enabled, disabled, include_platform_defaults); null when plan uses default settings.

plan_type'renewal' | 'one_time' required

Billing model for this plan.

productobject nullable required

Product this plan belongs to; null for standalone plans.

purchase_urlstring required

URL where customers can purchase this plan directly.

release_method'buy_now' | 'waitlist' required

Sales method for this plan.

renewal_pricenumber required

Recurring price charged every billing period.

split_pay_required_paymentsnumber nullable required

Installment payments required before the subscription pauses. Must be greater than 1. null if split pay is not configured.

stocknumber nullable required

Units available for purchase. null unless the actor has the plan:basic:read scope on the plan's account.

strike_through_initial_pricenumber nullable required

Original initial price shown with a strikethrough, in the plan's currency. null when no strikethrough is set.

strike_through_renewal_pricenumber nullable required

Original renewal price shown with a strikethrough, in the plan's currency. null when no strikethrough is set.

tax_type'inclusive' | 'exclusive' | 'unspecified' required

How tax is handled for this plan, including whether tax is included in the price, added at checkout, or not configured.

three_ds_level'mandate_challenge' | 'frictionless' | 'null' nullable required

3D Secure behavior for this plan; null inherits the account default.

titlestring nullable required

Plan display name shown to customers. Maximum 30 characters. null if no title has been set.

trial_period_daysnumber nullable required

Free trial days before the first renewal charge. null if no trial is configured or the user has already used a trial for this plan.

unlimited_stockboolean required

Whether the plan has unlimited stock. When true, the stock field is ignored; waitlist plans always report true.

updated_atstring required

When the plan was last updated, as an ISO 8601 timestamp.

visibility'visible' | 'hidden' | 'archived' | 'quick_link' required

Controls where this plan can be seen. When hidden, the plan is reachable only by its direct link.

Example response

{
  "account": {
    "id": "biz_xxxxxxxxxxxxxx",
    "title": "Shine Time Auto Detailing"
  },
  "adaptive_pricing_enabled": true,
  "billing_period": 30,
  "cancel_discount_intervals": 3,
  "cancel_discount_percentage": 20,
  "checkout_styling": {
    "background_color": "#0f172a",
    "border_style": "rounded",
    "button_color": "#f59e0b",
    "font_family": "roboto"
  },
  "created_at": "2026-01-01T12:00:00.000Z",
  "currency": "usd",
  "custom_fields": [
    {
      "field_type": "text",
      "id": "field_xxxxxxxxxxxxxx",
      "name": "Vehicle make and model",
      "placeholder": "2021 Audi S5",
      "required": true
    }
  ],
  "deletable": true,
  "description": "Two hand washes a month, interior vacuum, and a quarterly sealant top-up.",
  "expiration_days": 365,
  "formatted_price": "$59.00 / month",
  "id": "plan_xxxxxxxxxxxxxx",
  "image": {
    "blurhash": "LA6bDXT$E3b:R6i+RibEIWbp%ej1",
    "url": "https://assets-2-rough.whop.com/uploads/image/2026-01-01/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  },
  "internal_notes": "Maintenance tier. Upsell the interior shampoo add-on at renewal.",
  "invoice": {
    "id": "inv_xxxxxxxxxxxxxx"
  },
  "metadata": {},
  "offer_cancel_discount": true,
  "payment_method_configuration": {
    "disabled": [
      "crypto"
    ],
    "enabled": [
      "card"
    ],
    "include_platform_defaults": true
  },
  "plan_type": "renewal",
  "product": {
    "id": "prod_xxxxxxxxxxxxxx",
    "title": "Ceramic Coating Package"
  },
  "purchase_url": "https://whop.com/checkout/plan_xxxxxxxxxxxxxx",
  "release_method": "buy_now",
  "renewal_price": 59,
  "split_pay_required_payments": 4,
  "strike_through_initial_price": 99,
  "strike_through_renewal_price": 79,
  "tax_type": "unspecified",
  "three_ds_level": "frictionless",
  "title": "Unlimited Wash Club",
  "trial_period_days": 7,
  "updated_at": "2026-01-01T12:00:00.000Z",
  "visibility": "visible"
}