Create Product Schedules

Establish or reestablish a product schedule with multiple installments for an opportunity product. This resource is available in REST API version 43.0 and later. In API version 46.0 and later, established and re-established schedules support custom fields, validation rules, and Apex triggers.

URI: /services/data/vXX.X/sobjects/OpportunityLineItem/OpportunityLineItemId/OpportunityLineItemSchedules

Formats: JSON, XML

HTTP methods: PUT

Authentication: Authorization: Bearer token

Request parameters

ParameterDescription
typeThe type of the schedule. Required when establishing OpportunityLineItemSchedules. Valid values include Quantity, Revenue, or Both.
quantityThe total number of units to be repeated or divided in a quantity schedule. Must be an integer other than 0.
quantityScheduleTypeThe type of the quantity schedule, if the product has one. Valid values are Divide or Repeat.
quantityScheduleInstallmentPeriodIf the product has a quantity schedule, the amount of time covered by the schedule. Valid values are Daily, Weekly, Monthly, Quarterly, or Yearly.
quantityScheduleInstallmentsNumberIf the product has a quantity schedule, the number of installments. Can be an integer from 1 to 150.
quantityScheduleStartDateThe date the quantity schedule starts. Format is YYYY-MM-DD.
revenueThe amount of revenue to be repeated or divided.
revenueScheduleTypeThe type of the revenue schedule, if the product has one. Valid values are Divide or Repeat.
revenueScheduleInstallmentPeriodIf the product has a revenue schedule, the amount of time covered by the schedule. Valid values are Daily, Weekly, Monthly, Quarterly, or Yearly.
revenueScheduleInstallmentsNumberIf the product has a revenue schedule, the number of installments. Can be an integer from 1 to 150.
revenueScheduleStartDateThe date the revenue schedule starts. Format is YYYY-MM-DD.

Establish both quantity and revenue schedules for an opportunity product.

JSON Request body

Establish a revenue schedule only for an opportunity product.

JSON Request body

Establish a quantity schedule only for an opportunity product.

JSON Request body