# Create company

Allows users without a company to create a new company.

Endpoint: POST /api/2/companies
Version: 0.2.3120
Security: BasicAuth, BearerAuth

## Security:

  - `BasicAuth` (unknown)
    http basic

  - `BearerAuth` (unknown)
    http bearer JWT

## Request body:

  - `application/json` (unknown)
    The company's name

## Response 200:

  - `200` (unknown)
    Information about the created company.

## Response 200 fields (application/json):

  - `data` (object, required)

  - `data.id` (integer)

  - `data.name` (string)

## Response 400:

  - `400` (unknown)
    The company name may not be empty.

## Response 400 fields (application/json):

  - `errors` (array, required)
    List of errors that occurred during request processing
    Example: [{"code":"request.invalid","message":"The provided request data is invalid"},{"code":"resource.invalid","message":"The requested resource could not be found"}]

  - `errors.code` (string, required)
    Machine-readable error code for programmatic error handling.
Typically follows a structured format like 'request.invalid' or 'resource.invalid'.
    Example: request.invalid

  - `errors.message` (string, required)
    Human-readable error message providing details about the issue
    Example: The provided email address is not in a valid format

## Response 403:

  - `403` (unknown)
    User already belongs to a company.

## Response 403 fields (application/json):

  - `errors` (array, required)
    List of errors that occurred during request processing
    Example: [{"code":"request.invalid","message":"The provided request data is invalid"},{"code":"resource.invalid","message":"The requested resource could not be found"}]

  - `errors.code` (string, required)
    Machine-readable error code for programmatic error handling.
Typically follows a structured format like 'request.invalid' or 'resource.invalid'.
    Example: request.invalid

  - `errors.message` (string, required)
    Human-readable error message providing details about the issue
    Example: The provided email address is not in a valid format

## Response 500:

  - `500` (unknown)
    The company could not be created.

## Response 500 fields (application/json):

  - `errors` (array, required)
    List of errors that occurred during request processing
    Example: [{"code":"request.invalid","message":"The provided request data is invalid"},{"code":"resource.invalid","message":"The requested resource could not be found"}]

  - `errors.code` (string, required)
    Machine-readable error code for programmatic error handling.
Typically follows a structured format like 'request.invalid' or 'resource.invalid'.
    Example: request.invalid

  - `errors.message` (string, required)
    Human-readable error message providing details about the issue
    Example: The provided email address is not in a valid format