Skip to main content
POST
/
subscriptions
/
upgrade
Upgrade Subscription
curl --request POST \
  --url https://api.veryfront.com/subscriptions/upgrade \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "pro",
  "cycle": "monthly",
  "quantity": 3,
  "success_url": "<string>",
  "cancel_url": "<string>"
}
'
{
  "status": "<string>",
  "amount": "<string>",
  "checkout_url": "<string>",
  "error": "<string>"
}

Authorizations

​
Authorization
string
header
required

Authentication via JWT token or API key. JWT: Get from Veryfront dashboard. API Key: Format "vf__" - create via /api-keys endpoint.

Body

application/json
​
type
enum<string>
required

Subscription tier to upgrade to. "professional" is an alias for "pro".

Available options:
free,
pro,
enterprise,
professional
Example:

"pro"

​
cycle
enum<string>
required

Billing cycle

Available options:
monthly,
yearly
Example:

"monthly"

​
quantity
integer

Seat quantity for licensed subscriptions

Required range: x >= 1
Example:

3

​
success_url
string<uri>

URL to redirect to after successful payment

​
cancel_url
string<uri>

URL to redirect to if payment is cancelled

Response

Checkout session created

​
status
string
required
​
amount
string | null
​
checkout_url
string | null
​
error
string | null