Skip to main content
PUT
This endpoint updates subscription details including items, quantities, and payment methods. Plan changes take effect at the next billing cycle.

Authentication

This endpoint requires a valid API key with subscriptions:write permissions.

Path Parameters

string
required
The unique identifier of the subscription

Request Body

string
Change to a different plan (takes effect next billing cycle)
integer
Update subscription quantity
array
Update subscription items
string
Update default payment method
string
Apply a coupon
string
Extend or end trial period
object
Update custom fields

Response

Returns the updated subscription object.