---
title: "Create tenant integration"
method: POST
path: "/api/v2/integrations"
tags: ["Integrations"]
---

# Create tenant integration

`POST /api/v2/integrations`

## 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/v2/integrations`
- Auth: none declared

## Request body

- union
  - AzureSsoCreatePayload
    - `type` 'AZURE_SSO'
    - `azure_tenant_id` string, required
    - `azure_client_id` string, required
    - `azure_client_secret` string, password, required
    - `domain` string, required
    - `mail_reading_enabled` boolean
    - `mailbox_email` string, nullable
  - MinimaxCreatePayload
    - `type` 'MINIMAX'
    - `username` string, required
    - `password` string, password, required
    - `allowed_inbox_types` MinimaxInboxType[], nullable
    - `send_eslog_after_processing` boolean
    - `minimax_inbox_email_address` string, nullable
    - `attach_email_to_invoice` boolean
    - `read_inboxes` boolean
  - InforCreatePayload
    - `type` 'INFOR'

## Response `200`

Successful Response

- IntegrationResponse
  - `aggregate_id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `type` 'AZURE_SSO' | 'MINIMAX' | 'INFOR', required
  - `enabled` boolean, required
  - `settings` union, required
    - AzureSsoSettingsDTO
      - `name` 'AzureSsoSettings'
      - `domain` string, required
      - `provider_name` string, required
      - `mail_reading` AzureSsoMailReadingDTO, required
        - `enabled` boolean, required
        - `mailbox_email` string, nullable, required
    - MinimaxSettingsDTO
      - `name` 'MinimaxSettings'
      - `username` string, required
      - `allowed_inbox_types` MinimaxInboxType[], required
      - `send_eslog_after_processing` boolean, required
      - `minimax_inbox_email_address` string, nullable, required
      - `attach_email_to_invoice` boolean, required
      - `read_inboxes` boolean, required
    - InforSettingsDTO
      - `name` 'InforSettings'
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, 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)