Tiered Pricing on the Objects API

Status: Idea Submitted

Currently, HubSpot supports complex pricing models—such as Volume, Graduated, and Stair-step pricing—within the Commerce Hub / User interface. However, this functionality is seemingly completely inaccessible via the public API.

When making POST or PATCH requests to the /crm/v3/objects/products or /crm/v3/objects/line_items endpoints, developers are restricted to passing a single, flat-rate price. There is no schema available to define pricing tiers, billing frequency adjustments based on tiers, or specific pricing models programmatically. We do have the ability to define the pricing model used, but no way to actually set the prices for anything other than the flat tier. This is also not well documented so its difficult to find this limitation exists.

Please expose the existing tiered pricing schema to the public Products and Line Items APIs.

Specifically, we need the ability to pass an array or JSON object during creation/updates that defines:

  1. Pricing Model: (e.g., flat, volume, graduated)
  2. Tier Arrays: minimum_quantity, maximum_quantity, and price per tier.

This would allow for various automation and processes to be created via the API.