Skip to main content
POST
/
workspaces
/
{workspaceId}
/
billing-accounts
Create a billing account
curl --request POST \
  --url https://api.altostrat.io/workspaces/{workspaceId}/billing-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "ACME Corp (EU)",
  "email": "billing-eu@acme.com",
  "phone": "+442071234567",
  "description": "For all European operations.",
  "currency": "eur",
  "address": {
    "country": "US",
    "line1": "123 Main Street",
    "line2": "Suite 456",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105"
  }
}'
{
  "id": "cus_a1b2c3d4e5f6g7h8",
  "workspace_id": "ws_a1b2c3d4e5f6g7h8",
  "name": "ACME Corp Billing",
  "email": "billing@acme.com",
  "phone": "+15551234567",
  "description": "For US-based operations",
  "currency": "usd",
  "address": {
    "country": "US",
    "line1": "123 Main Street",
    "line2": "Suite 456",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105"
  },
  "created_at": "2025-10-29T00:40:06.000000Z",
  "updated_at": "2025-10-29T00:40:06.000000Z"
}

Authorizations

​
Authorization
string
header
required

Enter your JWT in the format: Bearer {token}

Path Parameters

​
workspaceId
string
required

The ID of the workspace.

Example:

"ws_a1b2c3d4e5f6g7h8"

Body

application/json
​
name
string
required

The name for the new billing account. Maximum 100 characters.

Example:

"ACME Corp (EU)"

​
email
string<email>
required

The primary billing email address. Maximum 150 characters.

Example:

"billing-eu@acme.com"

​
phone
string | null

The billing contact phone number. Maximum 50 characters.

Example:

"+442071234567"

​
description
string | null

An optional description for the billing account. Maximum 200 characters.

Example:

"For all European operations."

​
currency
enum<string>

The three-letter ISO currency code. If not provided, it will default based on the workspace or system settings.

Available options:
usd,
zar,
eur,
gbp,
aud
Example:

"eur"

​
address
object

Response

The billing account was created successfully.

​
id
string

Unique identifier for the billing account (Stripe Customer ID), prefixed with cus_.

Example:

"cus_a1b2c3d4e5f6g7h8"

​
workspace_id
string

The ID of the workspace this billing account belongs to.

Example:

"ws_a1b2c3d4e5f6g7h8"

​
name
string

The name of the billing account.

Example:

"ACME Corp Billing"

​
email
string<email>

The primary billing email address.

Example:

"billing@acme.com"

​
phone
string | null

The billing contact phone number.

Example:

"+15551234567"

​
description
string | null

An optional description for the billing account.

Example:

"For US-based operations"

​
currency
enum<string>

The three-letter ISO currency code for the billing account.

Available options:
usd,
zar,
eur,
gbp,
aud
Example:

"usd"

​
address
object
​
created_at
string<date-time>

The timestamp when the billing account was created.

Example:

"2025-10-29T00:40:06.000000Z"

​
updated_at
string<date-time>

The timestamp when the billing account was last updated.

Example:

"2025-10-29T00:40:06.000000Z"