---
title: "Add a new tenant"
method: POST
path: "/api/tenants"
tags: ["Tenants"]
---

# Add a new tenant

`POST /api/tenants`

No authorization check

## Request body

- Tenant — The tenant API object
  - `id` integer — The unique object id (immutable)
  - `status` 'Active' | 'Inactive' — The object status
  - `created` string, date-time — The date which the API object was created (immutable)
  - `updated` string, date-time — The date which the API object was last updated (immutable)
  - `identifier` string, required — The unique identifier of the tenant (immutable)
  - `culture` string, nullable — The tenant culture name based on RFC 4646 (fallback: system culture)
  - `calendar` string, nullable — The tenant calendar (fallback: default calendar)
  - `attributes` object, nullable — Custom attributes

## Response `201`

Created

- Tenant — The tenant API object
  - `id` integer — The unique object id (immutable)
  - `status` 'Active' | 'Inactive' — The object status
  - `created` string, date-time — The date which the API object was created (immutable)
  - `updated` string, date-time — The date which the API object was last updated (immutable)
  - `identifier` string, required — The unique identifier of the tenant (immutable)
  - `culture` string, nullable — The tenant culture name based on RFC 4646 (fallback: system culture)
  - `calendar` string, nullable — The tenant calendar (fallback: default calendar)
  - `attributes` object, nullable — Custom attributes

## Other responses

- `404` — Not Found
- `422` — Client Error

## Changes

- **2023-07-23** `fd1b5146be4a` — 24 warning, 110 info
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/isUnmanagedFunctionPointer` from the response with the `422` status
  - …130 more

[Change history](https://skmtc.dev/payroll-engine/apis/payroll-engine-backend-api-v1/changes/api/tenants/post.md)

---

[API](https://skmtc.dev/payroll-engine/apis/payroll-engine-backend-api-v1.md) · [All operations](https://skmtc.dev/payroll-engine/apis/payroll-engine-backend-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payroll-engine/payroll-engine-backend-api-v1/revisions/fd1b5146be4a/schema)