Skip to main content
POST
/
workspaces
/
{workspace_id}
/
billing-accounts
/
{billing_account_id}
/
subscriptions
Create Subscription
curl --request POST \
  --url https://api.altostrat.io/workspaces/{workspace_id}/billing-accounts/{billing_account_id}/subscriptions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "product_quantities": {},
  "metadata": {}
}'
{
  "id": "<string>",
  "billing_account_id": "<string>",
  "status": "active",
  "currency": "usd",
  "product_quantities": {},
  "plan_id": "<string>",
  "current_period_start": "2023-11-07T05:31:56Z",
  "current_period_end": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Auth0 JWT token for user authentication.

Path Parameters

​
workspace_id
string
required

The unique identifier for the workspace.

Example:

"ws_abc123"

​
billing_account_id
string
required

The unique identifier for the billing account (Stripe customer ID).

Example:

"cus_abc123"

Body

application/json
​
product_quantities
object
required

Map of product lookup_key to quantity.

​
metadata
object

Response

Subscription created successfully.

​
id
string

Stripe subscription ID (sub_...)

​
billing_account_id
string
​
status
enum<string>
Available options:
active,
past_due,
unpaid,
canceled,
incomplete,
incomplete_expired,
trialing,
paused
​
currency
enum<string>
Available options:
usd,
eur,
gbp,
aud,
zar
​
product_quantities
object
​
plan_id
string | null
deprecated
​
current_period_start
string<date-time> | null
​
current_period_end
string<date-time> | null
​
created_at
string<date-time>
​
updated_at
string<date-time>
⌘I