ChargebeeAPI

Create a subscription ramp

Idempotency SupportedBatch
Try in API Explorer

Creates a ramp for a subscription.

Note

  • Subscription status: You cannot create ramps for subscriptions in the paused or cancelled status.
  • Advance invoice: You cannot create ramps for subscriptions that have an advance invoice schedule.
  • Upcoming ramps limit: A subscription can have a maximum of 12 upcoming ramps at any given time, excluding deleted ramps. Upcoming ramps are ramps with status as scheduled.
  • Total ramps limit: A subscription can have a maximum of 100 ramps at any given time, excluding deleted ramps.
  • You cannot create a ramp for subscription, when ramps are in draft status.

Sample Request

URL Format

POST https://[site].chargebee.com/api/v2/subscriptions/{subscription-id}/create_ramp

Input Parameters

effective_from
required, timestamp(UTC) in seconds

The time when this ramp takes effect.

Caution

  • Ensure the time is within five years from the current time.
  • Ensure there is a minimum 24-hour interval between effective_from of two consecutive ramps.
  • If the subscription is scheduled to be paused or canceled in the future, ensure the time is not on or after pause_date or cancelled_at.
description
optional, string, max chars=250

A brief summary of the pricing changes applied with this ramp.

coupons_to_remove
optional, string

List of coupons removed from the subscription through this ramp.

Caution Ensure this list does not include:

  • Coupons being added through this ramp.
  • Coupons already removed by a previous ramp.
discounts_to_remove
optional, string

List of discounts removed from the subscription through this ramp.

Caution Ensure this list does not include discounts already removed by a previous ramp.

items_to_remove
optional, string

List of item prices removed from the subscription through this ramp.

Caution Ensure this list does not include:

  • Item prices being added or updated through this ramp.
  • Item prices already removed by a previous ramp.
contract_term
optional, enumerated string

An object that specifies the contract term details.

items_to_add
optional, string

Details about the item prices added to the subscription through this ramp.

items_to_update
optional, string

Details about the item prices updated in the subscription through this ramp.

item_tiers
optional, string

Note Allowed only when both of these conditions are met:

  • Price overriding is enabled for the site.
  • pricing_model of the item price is either tiered, volume, or stairstep.

Replaces the existing item_tiers for specific item_prices within the subscription. You must provide the complete tier set for any item_price, even if you're changing the price for only one tier.

coupons_to_add
optional, string

Details about the coupons added to the subscription through this ramp.

discounts_to_add
optional, enumerated string

Details about the discounts added to the subscription through this ramp.

Returns

rampRamp object

Resource object representing ramp