Skip to main content
POST
Extend a subscription

Overview

Extend an active subscription’s contract period. Extensions allow customers to keep their device longer than the original contract term, typically at a reduced monthly rate.

When to Use Extensions

Extension Benefits

  • For customers: Keep familiar device at lower monthly cost
  • For operators: Continue earning revenue on fully depreciated assets
  • For both: No logistics costs (no return/ship new device)

Request Fields

Basic Example

Example with Price Adjustment

Extensions are a great opportunity to offer loyalty discounts. Assets are often fully paid off by the end of the initial contract, so lower extension rates can still be highly profitable.

What Happens

When you extend a subscription:
  1. End date pushed forward by extension months
  2. Contract length updated to reflect total duration
  3. Monthly amount updated (if new price provided)
  4. Extension history logged with details
  5. Future payments scheduled at new rate

Pricing Strategy for Extensions

Extension History

After extending, the subscription tracks extension history:

Common Extension Periods

Error Handling

Authorizations

Authorization
string
header
required

API key obtained from FlexPortal dashboard

Headers

Tenant-ID
string
required

Your tenant identifier

Path Parameters

subscriptionId
string
required

The subscription ID

Body

application/json
rentalId
string
required
Minimum string length: 1
extensionMonths
integer
required
Required range: 1 < x <= 120
reason
string
required
Minimum string length: 1
newMonthlyAmount
number
Required range: x >= 0
notes
string

Response

Extension completed

success
enum<boolean>
required
Available options:
true
message
string
required
rentalId
string
required
assetSerialNumber
string
required
oldEndDate
string
required
newEndDate
string
required
extensionMonths
integer
required
Required range: 0 <= x <= 120
oldContractLength
integer
required
Required range: 1 < x <= 120
newContractLength
integer
required
Required range: 1 < x <= 120