Subscriptions
Create subscription update
API documentation
Integrations
Analytics
Billable events
Companies
Custom properties
Customers
Customers > Credits
Customers > Payment methods
Integrations
Invoices
Invoicing entities
Organisations
Payments
Price configurations
Quotes
Subscriptions
- GETGet subscriptions
- GETGet subscription
- GETGet subscription phases
- GETGet subscription phase
- POSTCreate subscription update
- POSTCreate subscription updates
- POSTCreate subscription
- PUTUpdate subscription
- POSTActivate subscription
- POSTCancel subscription
- POSTPause subscription
- POSTReactivate subscription
- POSTRefresh seat products
- POSTRefresh subscriptions
- POSTReinstate subscription
- POSTTransition subscription to next phase
Third-party apps
Wallets
Subscriptions
Create subscription update
Create an update to apply on an existing subscription.
POST
/
v1
/
subscriptions
/
{id}
/
update
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_product",
"payload": {
"product_id": "<string>",
"product_name": "<string>",
"product_description": "<string>",
"count": 1,
"billing_interval_period": "days",
"billing_interval_count": 123,
"start_or_end": "start",
"display_interval_dates_in_description": true,
"type": "fee",
"prices": [
{
"type": "fee",
"amount": 123
}
]
}
}'
{
"id": "<string>"
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
Body
application/json
Add a new product to bill as part of the subscription.
Available options:
immediately
Available options:
immediately
, next_invoice
Available options:
pro_rata
, pay_in_full
, do_not_charge
Available options:
add_product
Available options:
days
, weeks
, quarters
, months
, years
, once
, all
Available options:
start
, end
Available options:
fee
Response
201
application/json
Subscription update created
Was this page helpful?
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_product",
"payload": {
"product_id": "<string>",
"product_name": "<string>",
"product_description": "<string>",
"count": 1,
"billing_interval_period": "days",
"billing_interval_count": 123,
"start_or_end": "start",
"display_interval_dates_in_description": true,
"type": "fee",
"prices": [
{
"type": "fee",
"amount": 123
}
]
}
}'
{
"id": "<string>"
}