---
title: "Create a new company"
method: POST
path: "/public/company/v1/create-company"
tags: ["Company"]
---

# Create a new company

`POST /public/company/v1/create-company`

## Request body

- CompanyCreationRequestV1
  - `chamberOfCommerceNumber` string, required
  - `contactFirstName` string, required
  - `contactLastName` string, required
  - `contactMobilePhoneNumber` string, required
  - `contactEmail` string, email, required
  - `provisions` ProvisionV1, required — Either fixedCostPriceFactor OR both percentage and minimumAmount must be provided. The fixedCostPriceFactor determines the cost price (hourly wage * fixedCostPriceFactor = cost price). The percentage and minimumAmount are applied on top of the cost price, where the highest of the two is invoiced. If the cost price is 20€, percentage is 5% and minimum amount is 0.50€, then the client will be invoiced for 21€ (5% of 20€ = 1€ > 0.50€) If the cost price is 20€, percentage is 5% and minimum amount is 2.50€, then the client will be invoiced for 22.50€ (2.50€ > 5% of 20€ = 1€) If only one of them is applicable, the other one can be set to 0.0
    - `fixedCostPriceFactor` number
    - `percentage` number
    - `minimumAmount` number
  - `iban` string — The IBAN of the company
  - `vatNumber` string — The VAT number of the company. Must be valid according to https://ec.europa.eu/taxation_customs/vies
  - `collectiveLabourAgreementNumber` integer — The unique number of the collective labour agreement, as returned from the /get-collective-labour-agreements endpoint.

## Response `200`

Successfully created a company

- CompanyCreationResponseV1
  - `companyId` string, uuid, required
  - `contactId` string, uuid, required

## Other responses

- `400` — The request could not be processed. This could be due to a number of reasons: * The request does not have all required data. * Data in the request is invalid. * Data in the request is inconsistent. * The operation is not allowed given the current state of the data.
- `401` — The request did not contain credentials identifying the caller, or the provided credentials were invalid.
- `403` — The data that the request referred to is inaccessible to the caller.

---

[API](https://skmtc.net/maqqie/apis/maqqie-public-api.md) · [All operations](https://skmtc.net/maqqie/apis/maqqie-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maqqie/maqqie-public-api/revisions/41e5cd97d4d7/schema)