---
title: "[Internal] Create business unit"
method: POST
path: "/api/business-units"
tags: ["Business Units"]
---

# \[Internal\] Create business unit

`POST /api/business-units`

## Request

- Base URL: `https://api.typless.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.typless.com/api/business-units`
- Auth: none declared

## Request body

- CreateBusinessUnitRequest
  - `business_unit_id` string, uuid, nullable
  - `name` string, required
  - `vat_id` string, nullable
  - `ident` string, nullable
  - `extract_line_items` boolean
  - `inbox_email` string, nullable
  - `notification_configuration` NotificationConfiguration, required
    - `notification_emails` string[]
    - `notify_new_document` boolean
    - `auto_response_new_document` boolean
    - `send_daily_summary` boolean
  - `email_whitelist_configuration` EmailWhitelistConfiguration, required
    - `allow_all` boolean
    - `whitelisted_emails` string[]
    - `whitelisted_domains` string[]
  - `document_type_id` string, uuid, nullable
  - `read_inbox` boolean, nullable
  - `integration_configuration` IntegrationConfigurationCreateDto
    - `import_configuration` union
      - AzureConfigurationCreateDto: client_id, client_secret and tenant_id are nullable if we want to update only email without user having to enter credentials at every update
        - `name` 'AzureConfigurationCreateDto'
        - `azure_client_id` string, nullable
        - `azure_client_secret` string, password, nullable
        - `azure_tenant_id` string, nullable
        - `domain` string, nullable
        - `email` string, nullable
      - BusinessUnitEmailImportConfigurationDto
        - `name` 'BusinessUnitEmailImportConfigurationDto'
        - `email` string, nullable
        - `proforma_email` string, nullable
        - `read_directly` boolean
        - `entries` EmailImportEntryDto[]
          - `email` string, required
          - `type` string, required
          - `document_category` string, nullable
      - MinimaxImportExportConfigurationCreateDto
        - `name` 'MinimaxImportExportConfigurationCreateDto'
        - `username` string, required
        - `password` string, password, required
    - `processing_configuration` union
      - ProcessingConfigurationDto
        - `name` 'ProcessingConfigurationDto'
        - `batch_splitting` boolean
        - `processing_flow` 'REVIEW_REQUIRED' | 'DIRECT_EXPORT'
        - `check_unique_invoices` boolean
        - `document_type_name` string, nullable
        - `add_timestamp_prefix_to_exported_invoices` boolean
      - MinimaxProcessingConfigurationDto
        - `name` 'MinimaxProcessingConfigurationDto'
        - `attach_email_to_invoice` boolean
        - `ignore_small_attachments` boolean
        - `send_eslog_after_processing` boolean
        - `minimax_inbox_email_address` string, nullable
        - `processing_flow` 'REVIEW_REQUIRED' | 'DIRECT_EXPORT'
        - `batch_splitting` boolean
        - `check_unique_invoices` boolean
        - `allowed_inbox_types` MinimaxInboxType[], nullable
    - `export_configuration` union
      - FolderExportConfigurationDto
        - `name` 'FolderExportConfigurationDto'
        - `folder_path` string, required
        - `export_eslog_envelope` boolean, required
      - EmailExportConfigurationDto
        - `name` 'EmailExportConfigurationDto'
        - `email` string, required
        - `export_eslog_envelope` boolean, required
      - ApiExportConfigurationDto
        - `name` 'ApiExportConfigurationDto'
        - `export_eslog_envelope` boolean
  - `email_import_configuration` BusinessUnitEmailImportConfigurationDto
    - `name` 'BusinessUnitEmailImportConfigurationDto'
    - `email` string, nullable
    - `proforma_email` string, nullable
    - `read_directly` boolean
    - `entries` EmailImportEntryDto[]
      - `email` string, required
      - `type` string, required
      - `document_category` string, nullable
  - `processing_configuration` ProcessingConfigurationDto
    - `name` 'ProcessingConfigurationDto'
    - `batch_splitting` boolean
    - `processing_flow` 'REVIEW_REQUIRED' | 'DIRECT_EXPORT'
    - `check_unique_invoices` boolean
    - `document_type_name` string, nullable
    - `add_timestamp_prefix_to_exported_invoices` boolean
  - `export_configuration` union
    - FolderExportConfigurationDto
      - `name` 'FolderExportConfigurationDto'
      - `folder_path` string, required
      - `export_eslog_envelope` boolean, required
    - EmailExportConfigurationDto
      - `name` 'EmailExportConfigurationDto'
      - `email` string, required
      - `export_eslog_envelope` boolean, required
    - ApiExportConfigurationDto
      - `name` 'ApiExportConfigurationDto'
      - `export_eslog_envelope` boolean
  - `minimax_configuration` BusinessUnitMinimaxConfigurationDto
    - `name` 'MinimaxConfiguration'
    - `minimax_inbox_email_address` string, nullable
    - `send_eslog_after_processing` boolean
    - `allowed_inbox_types` MinimaxInboxType[], nullable
  - `integration_type` 'INFOR' | 'ESLOG' | 'MINIMAX', required
  - `approval_configuration` ApprovalConfigurationDtoInput
    - `name` 'ApprovalConfiguration'
    - `enabled` boolean
    - `rules` ApprovalRuleDtoInput[]
      - `id` string, uuid, nullable
      - `name` string, nullable
      - `filters` FilterDTO[], required
        - `field_name` string, required
        - `operator` 'EQUALS' | 'NOT_EQUALS' | 'BEGINS_WITH' | 'LESS_THAN' | 'LESS_THAN_EQUALS' | 'GREATER_THAN' | 'GREATER_THAN_EQUALS' | 'BETWEEN' | 'IS_NULL' | 'IS_NOT_NULL' | 'MATCH_ANY' | 'MATCH_ALL' | 'IN' | 'NOT_IN', required
        - `values` string[], required
      - `filter_logic` 'AND' | 'OR'
      - `approvers` ApproverRefDto[]
        - `type` 'user' | 'role', required
        - `id` string, uuid, required
        - `identifier` string, nullable
      - `auto_approve` boolean
    - `default_approvers` ApproverRefDto[]
      - `type` 'user' | 'role', required
      - `id` string, uuid, required
      - `identifier` string, nullable

## Response `200`

Successful Response

- BusinessUnitDTO
  - `aggregate_id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `ident` string, nullable, required
  - `vat_id` string, nullable, required
  - `integration_type` 'INFOR' | 'ESLOG' | 'MINIMAX', required
  - `name` string, required
  - `active` boolean, required
  - `integration_configuration` IntegrationConfigurationResponseDto, required
    - `import_configuration` union
      - AzureConfigurationResponseDto
        - `name` 'AzureConfigurationResponseDto'
        - `email` string, required
      - BusinessUnitEmailImportConfigurationDto
        - `name` 'BusinessUnitEmailImportConfigurationDto'
        - `email` string, nullable
        - `proforma_email` string, nullable
        - `read_directly` boolean
        - `entries` EmailImportEntryDto[]
          - `email` string, required
          - `type` string, required
          - `document_category` string, nullable
      - MinimaxImportExportConfigurationResponseDto
        - `name` 'MinimaxImportExportConfigurationResponseDto'
        - `username` string, required
    - `processing_configuration` ProcessingConfigurationDto
      - `name` 'ProcessingConfigurationDto'
      - `batch_splitting` boolean
      - `processing_flow` 'REVIEW_REQUIRED' | 'DIRECT_EXPORT'
      - `check_unique_invoices` boolean
      - `document_type_name` string, nullable
      - `add_timestamp_prefix_to_exported_invoices` boolean
    - `export_configuration` union
      - FolderExportConfigurationDto
        - `name` 'FolderExportConfigurationDto'
        - `folder_path` string, required
        - `export_eslog_envelope` boolean, required
      - EmailExportConfigurationDto
        - `name` 'EmailExportConfigurationDto'
        - `email` string, required
        - `export_eslog_envelope` boolean, required
      - ApiExportConfigurationDto
        - `name` 'ApiExportConfigurationDto'
        - `export_eslog_envelope` boolean
  - `email_import_configuration` BusinessUnitEmailImportConfigurationDto, required
    - `name` 'BusinessUnitEmailImportConfigurationDto'
    - `email` string, nullable
    - `proforma_email` string, nullable
    - `read_directly` boolean
    - `entries` EmailImportEntryDto[]
      - `email` string, required
      - `type` string, required
      - `document_category` string, nullable
  - `processing_configuration` ProcessingConfigurationDto, required
    - `name` 'ProcessingConfigurationDto'
    - `batch_splitting` boolean
    - `processing_flow` 'REVIEW_REQUIRED' | 'DIRECT_EXPORT'
    - `check_unique_invoices` boolean
    - `document_type_name` string, nullable
    - `add_timestamp_prefix_to_exported_invoices` boolean
  - `export_configuration` union, required
    - FolderExportConfigurationDto
      - `name` 'FolderExportConfigurationDto'
      - `folder_path` string, required
      - `export_eslog_envelope` boolean, required
    - EmailExportConfigurationDto
      - `name` 'EmailExportConfigurationDto'
      - `email` string, required
      - `export_eslog_envelope` boolean, required
    - ApiExportConfigurationDto
      - `name` 'ApiExportConfigurationDto'
      - `export_eslog_envelope` boolean
  - `minimax_configuration` MinimaxConfiguration, required
    - `name` 'MinimaxConfiguration'
    - `dummy_customer_id` integer, nullable
    - `minimax_inbox_email_address` string, nullable
    - `send_eslog_after_processing` boolean
    - `allowed_inbox_types` MinimaxInboxType[], nullable
  - `number_invoices_waiting_review` integer, nullable
  - `extract_line_items` boolean
  - `read_inbox` boolean, required
  - `inbox_email` string, required
  - `notification_configuration` NotificationConfiguration, required
    - `notification_emails` string[]
    - `notify_new_document` boolean
    - `auto_response_new_document` boolean
    - `send_daily_summary` boolean
  - `approval_configuration` ApprovalConfigurationDtoOutput, required
    - `name` 'ApprovalConfiguration'
    - `enabled` boolean
    - `rules` ApprovalRuleDtoOutput[]
      - `id` string, uuid, nullable
      - `name` string, nullable
      - `filters` FilterDTO[], required
        - `field_name` string, required
        - `operator` 'EQUALS' | 'NOT_EQUALS' | 'BEGINS_WITH' | 'LESS_THAN' | 'LESS_THAN_EQUALS' | 'GREATER_THAN' | 'GREATER_THAN_EQUALS' | 'BETWEEN' | 'IS_NULL' | 'IS_NOT_NULL' | 'MATCH_ANY' | 'MATCH_ALL' | 'IN' | 'NOT_IN', required
        - `values` string[], required
      - `filter_logic` 'AND' | 'OR'
      - `approvers` ApproverRefDto[]
        - `type` 'user' | 'role', required
        - `id` string, uuid, required
        - `identifier` string, nullable
      - `auto_approve` boolean
    - `default_approvers` ApproverRefDto[]
      - `type` 'user' | 'role', required
      - `id` string, uuid, required
      - `identifier` string, nullable
  - `email_whitelist_configuration` EmailWhitelistConfiguration, required
    - `allow_all` boolean
    - `whitelisted_emails` string[]
    - `whitelisted_domains` string[]
  - `document_type_id` string, uuid, nullable, required
  - `in_deletion_since` string, date-time, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/typless/apis/typless-api.md) · [All operations](https://skmtc.dev/typless/apis/typless-api/llms.txt) · [OpenAPI document](https://skmtc.dev/typless/apis/typless-api/revisions/d614787a47ef?raw)