Products and Deal Products have new fields designed for managing and streamlining the sale of products that are billed recurrently. These fields are only available starting from the Advanced plan.

What is being added?

Products

The new fields are:

• billing_frequency - How often a customer is billed for access to a service or product
• billing_frequency_cycles - The number of times the billing frequency repeats for a product in a deal

These fields were added as body parameters to the following endpoints:

• POST /v1/products
• PUT /v1/products/{id}
• POST /v2/products
• PUT /v2/products/{id}

They were also added to the responses of the following endpoints:

• GET /v1/products
• GET /v1/products/{id}
• POST /v1/products
• PUT /v1/products/{id}
• GET /v2/products
• GET /v2/products/{id}
• POST /v2/products
• PATCH /v2/products/{id}

Deal Products

The new fields are:

• billing_frequency - How often a customer is billed for access to a service or product
• billing_frequency_cycles - The number of times the billing frequency repeats for a product in a deal
• billing_start_date - When the product will start to be billed

These fields were added as body parameters to the following endpoints:

• POST /v1/deals/{id}/products
• PUT /v1/deals/{id}/products
• GET /v2/deals/{id}/products
• POST /v2/deals/{id}/products
• PATCH /v2/deals/{id}/products

They were also added to the responses of the following endpoints:

• GET /v1/deals/{id}/products
• POST /v1/deals/{id}/products
• PUT /v1/deals/{id}/products
• GET /v2/deals/{id}/products
• POST /v2/deals/{id}/products
• PATCH /v2/deals/{id}/products
• GET /v2/deals/products

If you have any questions or comments, feel free to let us know in the Developer’s Community.