Skip to main content
PATCH
/
workspaces
/
{workspaceId}
/
billing-accounts
/
{billingAccountId}
Update a billing account
curl --request PATCH \
  --url https://api.altostrat.io/workspaces/{workspaceId}/billing-accounts/{billingAccountId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "ACME Corp (International)",
  "email": "global.billing@acme.com",
  "phone": "+15559876543",
  "description": "Primary account for all international billing.",
  "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"

โ€‹
billingAccountId
string
required

The ID of the billing account, which corresponds to a Stripe Customer ID (cus_...).

Example:

"cus_a1b2c3d4e5f6g7h8"

Body

application/json
โ€‹
name
string

The new name for the billing account.

Example:

"ACME Corp (International)"

โ€‹
email
string<email>

The new primary billing email address.

Example:

"global.billing@acme.com"

โ€‹
phone
string | null

The new billing contact phone number.

Example:

"+15559876543"

โ€‹
description
string | null

An updated description for the billing account.

Example:

"Primary account for all international billing."

โ€‹
address
object

Response

The updated billing account object.

โ€‹
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"