Subscriptions
Create subscription update
- Documentation
- API Reference
- Integrations
- Changelog
- Blog
- GETGet analytics
- GETGet companies
- GETGet custom properties
- POSTCreate custom property
- PUTUpdate custom property
- DELDelete custom property
- GETGet customers
- POSTCreate customer
- GETGet customer
- PUTUpdate customer
- DELDelete customer
- GETGet customer portal
- PUTArchive customer
- POSTBulk update providers/customers mapping
- GETList credit products
- POSTCreate credit product
- GETGet credit product
- GETList credit transactions
- POSTPurchase credits
- POSTTopup credits
- POSTCreate credits usage
- POSTCreate component token
- GETGet invoices
- POSTCreate one-off invoice
- POSTSends a draft invoice for payment
- GETGet invoice
- GETDownload invoice
- POSTCreate transaction
- GETGet invoicing entities
- POSTCreate invoicing entity
- GETGet invoicing entity
- PUTUpdate invoicing entity
- DELDelete invoicing entity
- POSTCreate payment
- POSTUpdate prices
- POSTRefresh subscriptions
- POSTCreate subscription update
- POSTCancel subscription
- POSTPause subscription
- POSTReactivate subscription
- GETGet subscriptions
- POSTCreate subscription
- GETGet subscription
- POSTRefresh seat products
Analytics
Companies
Custom properties
Customers
Customers > Credits
Integrations
Invoices
Invoicing entities
Payments
Price configurations
Subscriptions
Subscriptions
Create subscription update
Create an update to apply on an existing subscription.
POST
/
v1
/
subscriptions
/
{id}
/
update
Authorization
string
*
Bearer
Authorization
Required
string
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
id
string
*
id
Required
string
Option 1 · object
object
Add a new product to bill as part of the subscription
application_schedule
enum<string>
*
application_schedule
Required
enum<string>
payment_schedule
enum<string>
*
payment_schedule
Required
enum<string>
calculation_method
enum<string>
*
calculation_method
Required
enum<string>
type
enum<string>
*
type
Required
enum<string>
payload
Option 1 · object
*
payload
Required
object
product_id
string
*
product_id
Required
string
count
number
*
count
Required
number
billing_interval_period
enum<string>
*
billing_interval_period
Required
enum<string>
billing_interval_count
number
*
billing_interval_count
Required
number
product_name
string
*
product_name
Required
string
product_description
string
*
product_description
Required
string
start_or_end
enum<string>
*
start_or_end
Required
enum<string>
display_interval_dates_in_description
boolean
display_interval_dates_in_description
boolean
prices
array
*
prices
Required
array
type
enum<string>
*
type
Required
enum<string>
curl --request POST \
--url https://api.hyperline.co/v1/subscriptions/{id}/update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"application_schedule": "immediately",
"payment_schedule": "immediately",
"calculation_method": "pro_rata",
"type": "add_item",
"payload": {
"product_id": "<string>",
"count": 123,
"billing_interval_period": "days",
"billing_interval_count": 123,
"product_name": "<string>",
"product_description": "<string>",
"start_or_end": "start",
"display_interval_dates_in_description": true,
"prices": [
{
"type": "fee",
"amount": 123
}
],
"type": "fee"
}
}'
{
"id": "<string>"
}
Authorizations
Authorization
string
headerrequiredBearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
id
string
requiredBody
application/json
application_schedule
enum<string>
requiredAvailable options:
immediately
payment_schedule
enum<string>
requiredAvailable options:
immediately
calculation_method
enum<string>
requiredAvailable options:
pro_rata
, pay_in_full
, do_not_charge
type
enum<string>
requiredAvailable options:
add_item
payload
object
requiredpayload.product_id
string
requiredpayload.count
number | null
default: 1requiredpayload.billing_interval_period
enum<string>
requiredAvailable options:
days
, weeks
, quarters
, months
, years
, once
, all
payload.billing_interval_count
number
requiredpayload.product_name
string
requiredpayload.product_description
string
requiredpayload.start_or_end
enum<string>
requiredAvailable options:
start
, end
payload.display_interval_dates_in_description
boolean
payload.prices
object[]
requiredpayload.prices.type
enum<string>
requiredAvailable options:
fee
payload.prices.amount
number
requiredpayload.type
enum<string>
requiredAvailable options:
fee
Response
201 - application/json
id
string
requiredcurl --request POST \
--url https://api.hyperline.co/v1/subscriptions/{id}/update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"application_schedule": "immediately",
"payment_schedule": "immediately",
"calculation_method": "pro_rata",
"type": "add_item",
"payload": {
"product_id": "<string>",
"count": 123,
"billing_interval_period": "days",
"billing_interval_count": 123,
"product_name": "<string>",
"product_description": "<string>",
"start_or_end": "start",
"display_interval_dates_in_description": true,
"prices": [
{
"type": "fee",
"amount": 123
}
],
"type": "fee"
}
}'
{
"id": "<string>"
}