Skip to main content
Billing Contacts2026.8.0

Add a billing contact to a Space

Adds a new billing contact email to a Space. Only Space owners or admins may add contacts. Email is normalized to lowercase and must be valid. A maximum of 5 contacts is allowed per space, and duplicate emails are rejected.

POST/api/v1/billing/contacts

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 contact added. Returns an object with `contact: { id: uuid, email: string }`.

No response body schema supplied.

400

Invalid request parameters. spaceId/email missing or invalid (spaceId must be UUID, email must be valid).

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.

409

Conflict. Contact limit reached (max 5) OR contact already exists (duplicate email).

No response body schema supplied.

500

Membership lookup failed OR billing contacts lookup failed OR failed to add contact.

No response body schema supplied.

Was this helpful?