Subscription Renewals
Create Scheduled Renewal Configuration Item
Adds product and component line items to the scheduled renewal.
If your site has list vs sales pricing enabled, accepts renewal_configuration_item.custom_price.list_price_point_id, validates and persists it; omitted value follows existing/default behavior; with list vs sales pricing disabled, parameter is ignored (no validation/behavioral impact). This functionality is supported in the API, but is not currently supported in SDKs.
Authorization
BasicAuth AuthorizationBasic <token>
The username is a Maxio Chargify API key. The password is x.
In: header
Path Parameters
subscription_id*integer
The Chargify id of the subscription.
scheduled_renewals_configuration_id*integer
The scheduled renewal configuration id.
Request Body
application/json
renewal_configuration_item*|
Response Body
application/json
application/json
curl -X POST "https://example.com/subscriptions/0/scheduled_renewals/0/configuration_items.json" \ -H "Content-Type: application/json" \ -d '{ "renewal_configuration_item": { "item_type": "Component", "item_id": 57, "quantity": 1, "custom_price": { "pricing_scheme": "stairstep", "prices": [ { "starting_quantity": 1, "ending_quantity": null, "unit_price": 5 } ] } } }'{ "scheduled_renewal_configuration_item": { "id": 555, "subscription_id": 12345, "subscription_renewal_configuration_id": 987, "item_id": 42, "item_type": "Product", "item_subclass": "SubscriptionProduct", "price_point_id": 73, "price_point_type": "ProductPricePoint", "quantity": 1, "decimal_quantity": "1.0", "created_at": "2025-09-01T12:00:00Z" }}