CAcampfire
Revenue Recognition

Create Contract Subscription

Create a new contract subscription.

Evergreen vs standard:
- Standard contract subscriptions generally provide explicit lines and fixed start/end dates.
- Evergreen contract subscriptions can provide period_amount to auto-generate lines. Their dates must align
  to billing period boundaries and must not exceed the contract's current working_end_date.

Notes:
- Usage and milestone subscription flows are not supported for evergreen contracts.
- For evergreen contracts, period_amount is the source-of-truth amount per billing period.
- renewal_behavior:
  - FOLLOW_CONTRACT: subscription follows evergreen contract extension windows.
  - FIXED_END: subscription keeps its own fixed end_date and does not extend automatically.
post/rr/api/v1/contracts/{contract_id}/subscriptions

Request

Path parameters

contract_idinteger required

Request body

idinteger required
is_deletedboolean required
deleted_atstring date-time nullable required
linesstring required
product_namestring required
product_is_renewableboolean nullable required
product_bundlestring required
product_bundle_namestring required
total_valuenumber double required
last_modified_atstring date-time required
ratenumber double nullable
quantitynumber double nullable
renewal_behavior'FOLLOW_CONTRACT' | 'FIXED_END'
  • FOLLOW_CONTRACT - Follow Contract
  • FIXED_END - Fixed End Date
period_amountnumber double nullable

Evergreen-only input amount per billing period (for example 10000.00 for a quarterly period). Provide this to auto-generate lines for evergreen subscriptions. Ignored for non-evergreen writes.

invoiced_amount_migrationnumber double nullable

Migration-only: total amount already invoiced in a prior system. When provided, marks revenue transactions as migration-invoiced up to this amount.

is_contract_amendmentboolean
start_datestring date nullable
end_datestring date nullable
mrrnumber double nullable
discountnumber double nullable

Per-unit discount in contract currency. Line amount is Quantity × (Rate − Discount). Null when no discount is configured.

notesstring nullable
use_daily_accountingboolean
proration_method'standard' | 'thirty_day' | 'daily'
  • standard - Standard (actual month length)
  • thirty_day - Fixed 30-day month
  • daily - Daily
use_catchupboolean
catchup_datestring date nullable
catchup_manually_overriddenboolean

True when a user explicitly set use_catchup or catchup_date via the modal. Suppresses automatic reconciliation by integration syncs so the user's choice survives.

invoice_calculation'FIXED_RATE' | 'FIXED_QUANTITY'
  • FIXED_RATE - Fixed Rate
  • FIXED_QUANTITY - Fixed Quantity
created_atstring date-time required
source'SALESFORCE' | 'HUBSPOT' | 'STRIPE' | 'MANUAL'
  • SALESFORCE - Salesforce
  • HUBSPOT - Hubspot
  • STRIPE - Stripe
  • MANUAL - Manual
external_idstring nullable
rates_are_netboolean

When True, this subscription's rate and waterfall amounts already reflect post-discount (net) pricing. Prevents invoice creation from double-counting discounts via a separate Discount RevenueTransaction.

customerinteger required
contractinteger required
productinteger nullable
modified_subscriptioninteger nullable

Response

idinteger required
is_deletedboolean required
deleted_atstring date-time nullable required
linesstring required
product_namestring required
product_is_renewableboolean nullable required
product_bundlestring required
product_bundle_namestring required
total_valuenumber double required
last_modified_atstring date-time required
ratenumber double nullable
quantitynumber double nullable
renewal_behavior'FOLLOW_CONTRACT' | 'FIXED_END'
  • FOLLOW_CONTRACT - Follow Contract
  • FIXED_END - Fixed End Date
period_amountnumber double nullable

Evergreen-only input amount per billing period (for example 10000.00 for a quarterly period). Provide this to auto-generate lines for evergreen subscriptions. Ignored for non-evergreen writes.

invoiced_amount_migrationnumber double nullable

Migration-only: total amount already invoiced in a prior system. When provided, marks revenue transactions as migration-invoiced up to this amount.

is_contract_amendmentboolean
start_datestring date nullable
end_datestring date nullable
mrrnumber double nullable
discountnumber double nullable

Per-unit discount in contract currency. Line amount is Quantity × (Rate − Discount). Null when no discount is configured.

notesstring nullable
use_daily_accountingboolean
proration_method'standard' | 'thirty_day' | 'daily'
  • standard - Standard (actual month length)
  • thirty_day - Fixed 30-day month
  • daily - Daily
use_catchupboolean
catchup_datestring date nullable
catchup_manually_overriddenboolean

True when a user explicitly set use_catchup or catchup_date via the modal. Suppresses automatic reconciliation by integration syncs so the user's choice survives.

invoice_calculation'FIXED_RATE' | 'FIXED_QUANTITY'
  • FIXED_RATE - Fixed Rate
  • FIXED_QUANTITY - Fixed Quantity
created_atstring date-time required
source'SALESFORCE' | 'HUBSPOT' | 'STRIPE' | 'MANUAL'
  • SALESFORCE - Salesforce
  • HUBSPOT - Hubspot
  • STRIPE - Stripe
  • MANUAL - Manual
external_idstring nullable
rates_are_netboolean

When True, this subscription's rate and waterfall amounts already reflect post-discount (net) pricing. Prevents invoice creation from double-counting discounts via a separate Discount RevenueTransaction.

customerinteger required
contractinteger required
productinteger nullable
modified_subscriptioninteger nullable

Changes

No recorded changes to this operation across all 1 revision of this API.