Skip to main content
POST
/
v1
/
public
/
accounts
/
{account_id}
/
billing
/
change-plan
Change Billing Plan
curl --request POST \
  --url https://api.hybridbox.io/v1/public/accounts/{account_id}/billing/change-plan \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "effective_date": "2023-11-07T05:31:56Z"
}
'
{
  "status": "<string>",
  "account_status": "<string>",
  "effective_at": "2023-11-07T05:31:56Z",
  "eligible": true,
  "previous_plan_id": "<string>",
  "target_plan_id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.hybridbox.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Public API bearer credential sent as Authorization: Bearer <token>. Use either an OAuth access token or a Hybridbox Service account token.

Path Parameters

​
account_id
string<uuid>
required

Body

application/json

Customer request schema for changing an account subscription plan.

​
plan_id
enum<string>
required

Target billing plan ID

Available options:
smtp_per_mailbox,
smtp_per_proxy
​
effective_date
string<date-time> | null

Requested effective date for the plan change

Response

​
status
string
required

Billing operation status

​
account_status
string | null

Account status after the operation

​
effective_at
string<date-time> | null

When the billing change took effect

​
eligible
boolean | null

Whether the account was eligible for the operation

​
previous_plan_id
string | null

Previous billing plan ID

​
target_plan_id
string | null

Target billing plan ID