Preview a renewal date change

Use this endpoint when the subscription's billing-date policy requires a preview before confirmation.

Authorization

bearerAuth

AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

Path Parameters

productSubscription*integer

The productSubscription path parameter.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

idempotency_key?|

Optional idempotency key. You may also send this as the Idempotency-Key header.

Lengthlength <= 128

renewal_date*string

Formatdate-time

reason?|

Lengthlength <= 500

metadata?

Response Body

`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."
}