POST /items/{item-id}

The device from which the customer has made the request

Default value: "application/x-www-form-urlencoded"

skip only webhooks

Possible values:

• "all-disabled"

If the site has multiple business entities, you can use this custom HTTP header to specify the business entity for which Chargebee should perform the operation.

skip all actions to be done on the events

Possible values:

• "all-disabled"

The email address of your customer/user. Use this when the email address has only ASCII characters.

The IP address of the customer where the request originated

The Base64-encoded email address of your customer/user. Use this if the email address has UTF-8 characters. When this header is provided, the header chargebee-request-origin-user is ignored.

skip only emails

Possible values:

• "all-disabled"

The list of ids of addon-items and charge-items that can be applied to the plan-item. This parameter can be provided only for plan-items and that too when item_applicability is restricted. Other details of attaching items can be specified using the Create or Update an attached item API.

The item is included in MRR calculations for your site. This attribute is only applicable for items of type = charge and when the feature is enabled in Chargebee. Note: If the site-level setting is to exclude charge-items from MRR calculations, this value is always returned false.

Description of the item. This is visible only in Chargebee and not to customers.
Note :

• The description field supports up to 2000 characters, including HTML tags. The inner text (excluding HTML tags) must not exceed 500 characters.
  For example:
  <ul><li>testing</li><li>desc</li></ul>.
  Total with tags: 38 characters,
  inner text: 'testing desc' (12 characters).
• If your input includes characters requiring sanitization, such as incomplete HTML tags, the sanitization process may alter the input and increase its length. If the sanitized content exceeds the allowed limit, the request will be rejected.

A collection of key-value pairs that provides extra information about the item. [Learn more](advanced-features#metadata).

The status of the item. * active - The item can be used to create new item prices. * deleted - Indicates that the item has been deleted. The id and name can be reused. Deleted items can be retrieved using List items. * archived - The item is no longer active and no new item prices can be created

Possible values:

• "active"
• "archived"

Parameters for bundle_items_to_update

Quantity of the item(plan, addon, and charge) associated with the bundle.

Price allocation of the item(plan, addon, and charge) associated with the bundle.

item_id that needs to be updated from the bundle plan. This attribute is only applicable when the item_type is plan.

Allow the plan to subscribed to via Checkout. Applies only for plan-items.
Note: Only the in-app version of Checkout is supported for Product Catalog v2.

Default value: true

The unit of measure for a quantity-based item. This is displayed on the Chargebee UI and on customer facing documents/pages. The latter includes hosted pages, invoices and quotes. Examples follow:

• "user" for a cloud-collaboration platform.
• "GB" for a data service.
• "issue" for a magazine.

Default value: false

Parameters for bundle_items_to_remove

item_id that needs to be removed from the bundle plan.
Note: This attribute is only applicable when the item_type is plan.

The display name for the item. Must be unique. This is visible only in Chargebee and not to customers.

If enabled_for_checkout, then the URL to be redirected to once the checkout is complete. This parameter is only meant for plan-items.

Parameters for `bundle_items_to_add`

Quantity of the item(plan, addon, and charge) associated with the bundle.

Price allocation of the item(plan, addon, and charge) associated with the bundle.

item_id that needs to be added to the bundle.
Note: This parameter is only applicable when the item_type is plan.

A unique display name for the item.

Parameters of `bundle_configuration`

Type of the bundle * fixed - Fixed bundle_configuration.type should be provided when you create a bundle plan that cannot be updated during checkout or subscription creation.

Possible values:

• "fixed"

Indicates that the item is a physical product. If Orders are enabled in Chargebee, subscriptions created for this item will have orders associated with them.

Default value: false

Indicates which addon-items and charge-items can be applied to the item. Only possible for plan-items. Other details of attaching items such as whether to attach as a mandatory item or to attach on a certain event, can be specified using the Create or Update an attached item API. * all - all addon-items and charge-items are applicable to this plan-item. * restricted - only the addon-items or charge-items provided in applicable_items can be applied to this plan-item.

Possible values:

• "restricted"
• "all"

Default value: "all"

The URL to redirect to once the gift has been claimed by the receiver.

The id of the Item family that the item belongs to. Is mandatory when Product Families have been enabled.

Allow customers to change their subscription to this plan via the Self-Serve Portal. Applies only for plan-items. This requires the Portal configuration to allow changing subscriptions.

Default value: true