Skip to main content

Build an offering

POST 
/subscriptions/offerings/build

An offering includes products and plans; products are combined with one or more plans to form an offering. An offering can include either:

Offerings represent a snapshot of their products and plans. If you make updates to products or plans within an offering, the original products and plans are not updated. Only the products and plans within the offering are updated. Alternatively, you can create new products or plans and attach them to an existing offering.

When you are building an offering:

  • you can create new plans and products.
  • you can modify an existing product and plans. For example, you can modify the product price or any attributes of a plan included in the offering.

Here's how you build an offering:

  1. Specify the product to build with the offering. A product can be:

    • subscription products. Specify the subscription product attributes.
    • Product Experience Manager products. Specify the Product Experience Manager product ID in external_ref in ProductAttributes. For the remaining product attributes, you can specify their values to match the values of the existing Product Experience Manager product attributes. However, you can also specify different values, depending on your requirements.

  2. Specify the plans to build with the offering. Plans are the rules that govern your subscription, for example, any discount. You can combine and reuse plans for as many products as you want, making it quick and easy to create your subscription offerings. An offering must have at least one plan.

Request​

Responses​

Success. The new subscription offering is created with the specified subscription products and plans attached to the offering.