ResourcesSubscriptions
Preview a renewal date change
Preview a new renewal date before confirming it.
Use this endpoint when the subscription's billing-date policy requires a preview before confirmation.
Authorization
bearerAuth storeAuth AuthorizationBearer <token>
Provide your SellApp API key as a bearer token.
In: header
X-STORE<token>
Select the SellApp store for this API request.
In: header
Path Parameters
productSubscription*integer
The productSubscription path parameter.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://sell.app/api/v2/subscriptions/0/actions/change-renewal-date/preview" \ -H "Content-Type: application/json" \ -d '{ "renewal_date": "2026-08-01T12:00:00Z", "reason": "Billing alignment" }'{
"data": {
"preview_token": "subprev_9c4b2f",
"expires_at": "2026-07-03T12:15:00.000000Z",
"preview_payload": {
"estimated_total_cents": 1500
},
"request_payload": {
"target_variant_id": 4321
},
"customer_message": null,
"seller_message": null
},
"message": "Subscription renewal date preview created."
}{
"message": "Unauthenticated."
}{
"message": "This action is unauthorized."
}{
"message": "Rule not found."
}{
"message": "The given data was invalid.",
"errors": {
"data": [
"The data field is required."
]
}
}