Company

Create a new company

Changed on Sep 29, 2026

post/public/company/v1/create-company

Request

Base URL
https://api.maqqie.app (the document declares no server; this is the origin it was published from)
Auth
OAuth 2
Client credentials
Token URLhttps://maqqie.app/auth/realms/maqqie/protocol/openid-connect/token
TypeScript
https://skmtc.dev/maqqie/apis/maqqie-public-api/docs/public/company/v1/create-company/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

chamberOfCommerceNumberstring required

contactFirstNamestring required

contactLastNamestring required

contactMobilePhoneNumberstring required

contactEmailstring email required

ibanstring

The IBAN of the company

vatNumberstring

The VAT number of the company. Must be valid according to https://ec.europa.eu/taxation_customs/vies

collectiveLabourAgreementNumberinteger

The unique number of the collective labour agreement, as returned from the /get-collective-labour-agreements endpoint.

Example request

{
  "chamberOfCommerceNumber": "69831955",
  "contactFirstName": "John",
  "contactLastName": "Doe",
  "contactMobilePhoneNumber": "+31612345678",
  "contactEmail": "johndoe@example.com",
  "provisions": {
    "fixedCostPriceFactor": 1.95,
    "percentage": 18.2,
    "minimumAmount": 18.21
  },
  "iban": "NL24RABO0648620387",
  "vatNumber": "NL290284636B95",
  "paymentTerm": {
    "days": 30,
    "surchargePercentage": 2.5
  }
}

Response

Successfully created a company

companyIdstring uuid required

contactIdstring uuid required

Changes

Sep 29, 2026f9510f3f4b22 Revision changes
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  the request's body type changed from no type to object
- breaking
  the response's body type changed from no type to object for status
- breaking
  the response's body type changed from no type to string for status
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
Sep 29, 20263352b56bb8fe Revision changes
- breaking
  the request's body type changed from object to no type
- breaking
  the response's body type changed from object to no type for status
- breaking
  the response's body type changed from string to no type for status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- warning
  removed the request property
- info
  response schema application/json enum value removed COMPANY_EXISTS
- info
  response schema application/json enum value removed EMAIL_DOMAIN_BLACKLISTED
- info
  response schema application/json enum value removed EMAIL_EXISTS
- info
  response schema application/json enum value removed FAILED_TO_GET_CHAMBER_OF_COMMERCE_DATA
- info
  response schema application/json enum value removed INVALID_EMAIL_ADDRESS
- info
  response schema application/json enum value removed INVALID_IBAN
- info
  response schema application/json enum value removed INVALID_PAYMENT_TERM_DAYS
- info
  response schema application/json enum value removed INVALID_PROVISIONS
- info
  response schema application/json enum value removed INVALID_SURCHARGE_PERCENTAGE
- info
  response schema application/json enum value removed INVALID_VAT_NUMBER
- info
  response schema application/json enum value removed PHONE_NUMBER_CANNOT_BE_PARSED
- info
  response schema application/json enum value removed PHONE_NUMBER_CANNOT_EXIST
- info
  response schema application/json enum value removed PHONE_NUMBER_DOES_NOT_START_WITH_COUNTRY_CODE
- info
  response schema application/json enum value removed PHONE_NUMBER_KIND_NOT_SUPPORTED
- info
  response schema application/json enum value removed UNSUPPORTED_CLA_NUMBER
- info
  response schema application/json enum value removed VAT_AND_CLA_ARE_BOTH_REQUIRED_OR_SHOULD_BOTH_BE_EMPTY

Operation history (9 revisions)