Skip to main content
Billing Profiles2026.8.0

Create billing profile for a space

Creates a billing profile for the given space. Requires an authenticated user with role owner or admin in the space. Validates the request payload and creates a Stripe customer plus a billing.customers row.

POST/api/v1/billing/profiles

The source export uses a local development server. Examples use the configured Dashio API origin.

The export references authentication schemes without supplying their definitions.

Authentication

bearerAuth

Understand authentication

Path parameters

None declared in this export.

Query parameters

None declared in this export.

Header parameters

None declared in this export.

Request body

application/json · Required

valueobjectOptional

No field description supplied.

Responses

200

Billing profile created. Returns BillingProfileResponse: address (BillingAddress), taxId (string|null), phone (PhoneNumberParts|null).

No response body schema supplied.

400

Bad Request. Payload validation failed OR spaceId missing in payload OR other validation errors thrown by validatePayload/createCustomer.

No response body schema supplied.

401

Unauthenticated.

No response body schema supplied.

403

Forbidden. User is not owner or admin of the space.

No response body schema supplied.

404

Space not found.

No response body schema supplied.

409

Billing profile already exists.

No response body schema supplied.

500

Failed to verify permissions, failed to create customer, or unexpected internal error.

No response body schema supplied.

Was this helpful?