put

Sets the next renewal date for a subscription. Useful for prorating billing cycles or handling deferred renewals — for example, aligning the next charge after switching a subscription's plan or cadence via PUT /v2/ecommerceSubscriptions/{id}.

This changes only the timing of the next renewal, not the cadence itself. If the subscription has an endDate, that end date is shifted by the same amount as the change to the next payment date, so the remaining paid duration is preserved.

Request body

{
  "renewalDate": "09-15-2026"
}

Response 200

{
  "success": true,
  "message": "Renewal date updated successfully",
  "data": {
    "id": "esub::123",
    "nextBillingDate": "2026-09-15T00:00:00.000Z"
  }
}

Errors

Required role

Affiliate token required