Add a line to a plan
Requires write:billing. Add a recurring product (e.g. another car’s storage at $350/month) to a customer’s existing plan. amountCents sets a custom price; a matching existing price is reused, otherwise one is created (hidden from the customer shop). Without confirm, nothing changes and the response has a plain-language summary, the plan before and after, and a previewToken. Calling again with the same arguments plus confirm: true and that previewToken applies the change. Takes effect with the next bill (no proration, nothing charged now). A stale token (the plan changed since the preview) is refused with 409; preview again.
Authorizations
Team API key from Settings → Integrations. Use Authorization: Bearer <key> or x-api-key.
Path Parameters
Subscription id from list_billing_subscriptions.
Body
Recurring product to add (from list_billing_products).
Price per billing period in cents (e.g. 35000 = $350.00), before tax and processing fees.
0 <= x <= 10000000An existing price to use (alternative to amountCents).
1 <= x <= 100Car this line bills for.
Leave out (or false) to preview: nothing changes, and the response has a summary and previewToken. With confirm: true and that previewToken, the change is applied.
From the preview. Required with confirm: true; refused if the plan or the change differs from what was previewed.
100Response
Preview (applied: false) or applied change (applied: true).