# Create a Company

Create a Company based on the provided details.

Endpoint: POST /companies
Version: 1.0.0
Security: api_key

## Security:

  - `api_key` (unknown)
    apiKey in header x-api-key

## Request fields (application/json):

  - `identificationNumber` (string)
    Identification number of the company, if provided must be valid

  - `name` (string, required)
    Name of the company

  - `headAddress` (object, required)
    Head office address of the company

  - `headAddress.street` (string, required)

  - `headAddress.streetNr` (string, required)

  - `headAddress.postalCode` (string, required)

  - `headAddress.box` (string)

  - `headAddress.city` (string, required)

  - `headAddress.countryCode` (string, required)

  - `headAddress.addressAdditionalLine` (string)

  - `emailAddress` (string)
    Email address of the company

  - `phoneNumber` (string)
    Phone number of the company

  - `isActive` (boolean, required)
    Indicates if the company is active

  - `identifiers` (array, required)
    List of identifiers associated with the company

  - `identifiers.type` (string, required)
    Enum: "ENTERPRISE_NUMBER", "VAT_NUMBER", "DUNS", "GLN", "LEITWEG_ID", "CODE_ROUTAGE", "SIRET_NUMBER", "NIP", "BANK_NAME", "BIC", "IBAN", "KVK_NUMBER", "OIN_NUMBER", "CFI", "PEC", "CODDEST", "CUU"

  - `identifiers.value` (string, required)

## Response 201 fields (application/json):

  - `erpId` (string, required)
    ERP identifier of the company

  - `identificationNumber` (string)
    Identification number of the company

  - `name` (string, required)
    Name of the company

  - `headAddress` (object, required)
    Head office address of the company

  - `headAddress.street` (string, required)

  - `headAddress.streetNr` (string, required)

  - `headAddress.postalCode` (string, required)

  - `headAddress.box` (string)

  - `headAddress.city` (string, required)

  - `headAddress.countryCode` (string, required)

  - `headAddress.addressAdditionalLine` (string)

  - `emailAddress` (string)
    Email address of the company

  - `phoneNumber` (string)
    Phone number of the company

  - `isActive` (boolean, required)
    Indicates if the company is active

  - `id` (string, required)
    Unique identifier of the company

  - `createdAt` (string, required)
    Creation date of the company

  - `lastModifiedAt` (string, required)
    Last modification date of the company

  - `lastModifiedBy` (string, required)
    Last modified by information

  - `identifiers` (array, required)
    List of identifiers associated with the company

  - `identifiers.type` (string, required)
    Enum: "ENTERPRISE_NUMBER", "VAT_NUMBER", "DUNS", "GLN", "LEITWEG_ID", "CODE_ROUTAGE", "SIRET_NUMBER", "NIP", "BANK_NAME", "BIC", "IBAN", "KVK_NUMBER", "OIN_NUMBER", "CFI", "PEC", "CODDEST", "CUU"

  - `identifiers.value` (string, required)

  - `isTechnologyPartner` (boolean)
    Indicates if the company is a technology partner

## Response 400:

  - `400` (unknown)
    Invalid company payload

## Response 403:

  - `403` (unknown)
    Identification number is not valid

## Response 409:

  - `409` (unknown)
    Identification number already in use

## Response 415:

  - `415` (unknown)
    Request Content-Type is not 'application/json'