Skip to main content

Extend Subscription

POST/subscriptions//extend
Extends a subscription’s current billing period by a specified number of days or months. This is useful for courtesy extensions, compensation for service outages, or promotional offers. You must provide either days or months (but not both).
This endpoint has an idempotency guard. If a duplicate request is made within 10 seconds, it will return 429 Too Many Requests instead of double-extending the subscription.

Authentication

Headers

Path Parameters

Request Body

Example Request

Success Response

Returns the full subscription object in the standard SubscriptionResource shape — identical to Get Subscription, List Subscriptions, and Lookup Subscriptions. The fields most relevant to extension are shown below — see Get Subscription for the complete field list.

Response Fields

The response is the full SubscriptionResource. See Get Subscription for the complete list. The fields most relevant to extension:
A subscription.updated webhook event is fired when a subscription is extended, including the number of days added and the new end date.

Error Responses