BizKitHub
DocsAPI ReferenceOrganisation/bff/organisation/create
postOrganisationAdmin BFF

/bff/organisation/create

Creates a new organisation and makes the authenticated user its root member. By default the org has no parent (managed directly by BizKitHub); the caller's current session org is never propagated as parent_id. A white-label partner may pass parentOrganisationSlug to place the org under its partner organisation. Requires authenticated user.

OrganisationpostBffOrganisationCreate

Parameters

JSON body

Request body

application/json
organisationNamestringRequired

Name of the new organisation. Must be unique.

Length: 1–∞
ExampleAcme Corp
timezonestringRequired

Timezone identifier (e.g., "Europe/Prague", "America/New_York").

ExampleEurope/Prague
descriptionstringOptional

Optional description of the organisation.

ExampleOur main production workspace.
countryIdnumberOptional

Primary HQ country FK (core__country.id, from GET /organisation/available-countries). Drives per-country security posture. If omitted, resolved from the request IP with Czech Republic as ultimate default.

Example158
companyRegistrationNumberstringOptional

Optional company registration number (IČO in CZ). When present and the registry for the resolved country is reachable (ARES for CZ), the self-contact is enriched with the official business name, address, DIČ and VAT payer status so the org is immediately ready to issue invoices. Admin UI hides this field outside CZ.

Example25596641
technicalEmailstringOptionalemail

Technical / accounting mailbox that becomes the e-mail of the org's accounting self-contact (internalCustomerId). When omitted or equal to the founder's address, a synthetic -org-<random>@ alias is minted (BC with pre-STEP 2 behaviour). Dedicated mailboxes like [email protected] land here.

defaultLocaleCodestringOptional

ISO 639-1 locale code for the org's primary language (cs, en, pl, sk, de, …). When omitted, derived from countryId via the country→defaults mapping (CZ→cs, SK→sk, …).

Examplecs
defaultCurrencyCodestringOptional

ISO 4217 currency code (CZK, EUR, PLN, USD, …). When omitted, derived from countryId via the country→defaults mapping (CZ→CZK, SK/DE/AT→EUR, PL→PLN, …).

ExampleCZK
parentOrganisationSlugstring | nullOptional
One of 2:
Variant 1
string

Integration partner (white-label) that will manage the new org (parent_id). Must be one of GET /organisation/white-label-parent-options — the caller must be an active member of an org with an active white-label licence. Omit / null = managed directly by BizKitHub.

Example7-napadu-s-r-o
Variant 2
null

Response schema

1 status code documented

200SuccessOrganisation created successfully.
successbooleanRequired

Always true on success.

Default: true

Response example

application/json
{
  "success": true
}

Request example

POST /bff/organisation/create

post
curl -X POST "https://api.bizkithub.com/bff/organisation/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "organisationName": "Acme Corp",
  "timezone": "Europe/Prague",
  "description": "Our main production workspace.",
  "countryId": 158,
  "companyRegistrationNumber": "25596641",
  "technicalEmail": "[email protected]",
  "defaultLocaleCode": "cs",
  "defaultCurrencyCode": "CZK"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key