Company

Create a KLARA business company

A Klara user might have multiple company tenants. Use this endpoint to create a business company and its correspondence tenant. Use your KLARA token from your username & password & tenant-id.

post/core/v2/tenants/companies

Request

  • Base URL: https://api.klara.ch
  • URL: https://api.klara.ch/core/v2/tenants/companies
  • Auth: one of:
    • API key in header X-API-KEY
    • HTTP bearer

Request body

namestring required

Name of the company

legalForm'LIMITED_LIABILITY' | 'CORPORATION' | 'OR' | 'INDIVIDUALLY_OWNED_COMPANY' | 'ASSOCIATION' | 'SIMPLE_PARTNERSHIP' | 'GENERAL_PARTNERSHIP' | 'LIMITED_PARTNERSHIP' | 'COOPERATIVE_COMPANY' | 'FOUNDATION' | 'IOER' required

Legal form of the company. Send the value as one of the LegalForm constants below; the German abbreviation in brackets is also accepted on input, but responses always carry the constant. <ul><li><code>LIMITED_LIABILITY</code> - limited liability company (GmbH)</li><li><code>CORPORATION</code> - public limited company (AG)</li><li><code>INDIVIDUALLY_OWNED_COMPANY</code> - individually owned company (EU)</li><li><code>ASSOCIATION</code> - association (V)</li><li><code>SIMPLE_PARTNERSHIP</code> - simple partnership (EG)</li><li><code>GENERAL_PARTNERSHIP</code> - general partnership (KG)</li><li><code>LIMITED_PARTNERSHIP</code> - limited partnership (KDG)</li><li><code>COOPERATIVE_COMPANY</code> - cooperative company (G)</li><li><code>FOUNDATION</code> - foundation (S)</li><li><code>OR</code> - simple company under the Swiss Code of Obligations (OR)</li><li><code>IOER</code> - institution of public law</li></ul>

language'de' | 'en' | 'fr' | 'it' required

Preferred language of the company. Supported: English, German, French, Italian

corporateIdentificationNumberstring

Every business active in Switzerland is given a unique enterprise identification number (UID). To ensure that numbers are correctly allocated and managed, the UID register is run by the Federal Statistical Office

foundingDatestring date

Founding date of this company in ISO 8601 format (yyyy-mm-dd)

Example request

{
  "name": "ABC-Corp",
  "legalForm": "LIMITED_LIABILITY",
  "phones": [
    {
      "id": "1",
      "phoneNumber": "+41783334444",
      "type": "PRIVATE"
    }
  ],
  "emails": [
    {
      "id": "1",
      "emailAddress": "example@gmail.com",
      "type": "PRIVATE"
    }
  ],
  "addresses": [
    {
      "id": "1",
      "addressLines": "Chemin de la Caquerette 12",
      "addressType": "WORK",
      "cityName": "Bern",
      "cityZipCode": "3003",
      "countryIso2Code": "CH",
      "countryIso3Code": "CHE",
      "countryNumericCode": "756",
      "city_href": "https://api.klara.ch/core/latest/cities/1",
      "definitionName": "2nd address",
      "additionalAddress": "No. 13, street 123"
    }
  ],
  "language": "de",
  "corporateIdentificationNumber": "CHE-123.456.789",
  "foundingDate": "2019-12-20"
}

Response

Tenant and company created

tenant_idstring
company_idinteger
company_namestring

Example response

[
  {
    "tenant_id": "aaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "company_id": 1,
    "company_name": "ABC Company"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.