Create business

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Request body

Schema: BusinessCreateRequest

namestringrequired

Business display name.

default_currencystring

Default currency for the business (USD, CAD, AUD, EUR, or GBP).

tax_year_end_monthinteger

Month when the tax/fiscal year ends (1-12). Default 12 = calendar year.

mailboxstring

Unique email prefix for bill forwarding. Auto-generated from the business name when omitted.

user_idstring

UUID of the user who will own this business. Optional for admin-created businesses.

create_teal_instanceboolean

If true, creates a new Teal accounting instance. Default false since DayZero local engine is now the default.

teal_instancestring

Existing Teal instance ID to use (if not creating new).

coa_template_idstring

Pre-built chart of accounts template ID. Mutually exclusive with custom_coa_template.

custom_coa_templateCustomCoaTemplate

Custom chart of accounts definition. Mutually exclusive with coa_template_id.

entries_startstring

Date from which to start importing transactions (YYYY-MM-DD).

firm_idstring

Advisory firm UUID to link this business to.

stripe_account_idstring

Stripe Connect account ID.

stripe_subscription_idstring

Stripe subscription ID for billing.

stripe_customer_idstring

Stripe customer ID (e.g., cus_xxx).

subscription_itemsobject

Stripe subscription items/products linked to this business.

accounting_engine_typestring

Accounting engine: 'local' (DayZero, default), 'teal', or null (inherit from firm).

Responses