---
title: "Create a new tenant"
method: POST
path: "/msp/v3/customers/{customerID}/tenants"
tags: ["Tenants"]
---

# Create a new tenant

`POST /msp/v3/customers/{customerID}/tenants`

- Creates a new tenant for a customer.
- After you initiate the operation, it is queued and a task ID is generated. You can get the task ID from the success response. Use this task ID in the 'Get Task Details' API to track the operation's progress.
- Note
    - This API does not support the creation of a Sandbox tenant.
    - Enterprise Workloads license is valid for eight years, while a SaaS Apps and Endpoints license is valid for three years.
    - Storage Regions once added, cannot be removed.
    - For SaaS Apps & Endpoint and Enterprise Workloads with Business Edition, any one storage region is supported.
   - The AWS and Azure storage regions must be in the same geographic location for ‘Business’ edition.
  -  At least one AWS storage region is required for Enterprise Workloads.
  - All features enabled in the associated Service plan will be enabled compulsorily for the tenant. Need to send those feature attributes in the API.
  - Feature Endpoints, D365 and Okta do not support business edition.
  - Premium Security is only supported for Enterprise Workloads.
   - If 'Premium Security' needs to be enabled for a tenant, Security Posture & Observability and Enterprise Workloads Accelerated Ransomware Recovery features both should be enabled for that tenant. 
   - For valid products and their values, see - https://developer.druva.com/docs/msp-product-and-attribute-values
  - View all supported storage regions here - https://help.druva.com/en/articles/15162912-aws-region-availability-matrix
.

## Path parameters

- `customerID` string, required

## Headers

- `Authorization` string, required

## Request body

- CreateTenantV3Request — - Specify the details for a new tenant.
  - `licenseExpiryDate` string, date-time, required — Specify the date on which the tenant will expire. The format for this parameter value is YYYY-MM-DDTHH:MM:SSZ. Example - '2022-10-25T00:00:00Z'
  - `quota` number, double — Specify the Druva Consumption Units to be allocated to this customer. If the customer is close to breaching this limit, an alert is sent to the configured email address based on the severity of the breach. Example - 1.5
  - `quotaStartDate` string, date-time — Specify the Start date from when the quota limit will be applicable to the customer account and the storage consumption usage begins. The format for this parameter value is YYYY-MM-DDTHH:MM:SSZ. Example - '2022-10-25T00:00:00Z'
  - `quotaEndDate` string, date-time — Specify the End date on which the quota limit will end for the customer account. The format for this parameter value is YYYY-MM-DDTHH:MM:SSZ. Example - '2022-10-25T00:00:00Z'
  - `servicePlanID` integer, required — - Specify the unique ID of the Service Plan that you wish to associate with the tenant. - Get the Service Plan ID using the 'List Service Plans' API.
  - `storageRegions` StorageRegions[], required — - Specify the storage regions where you want to store the tenant data specifying the 'name' of storage region and its associated storage provider. - Storage Provider values: 1 (AWS), 2 (Azure)
    - `name` string — - Name of the storage region. Example - 'us-east-1'
    - `storageProvider` integer — - Storage Provider (AWS/Azure) that is associated with the storage region. Storage Provider values: 1 (AWS), 2 (Azure)
  - `tenantType` integer, required — Specify the tenant type for the product. - Specify '1' if it is a Sandbox. - Specify '2' if it is Evaluation. This is a trial plan with a validity of 30 days. If you select this tenant type, the product license will be active until 30 days. After 30 days, you must change the tenant type to Commercial. - Specify '3' if it is Commercial. For this tenant type, a Enterprise Workloads license is valid for eight years, while a SaaS Apps and Endpoints license is valid for three years.
  - `productID` integer, required — Specify the ID of the product for which the tenant is being created. - To create the tenant for Enterprise Workloads, specify '1'. - To create the tenant for SaaS Apps and Endpoints, specify '2'
  - `features` TenantFeaturesV3[], required — Specify the list of features that must be enabled for the tenant. It cannot be empty.
    - `name` string — - Name of the feature. Example - 'M365' - For valid products and their values, see - https://developer.druva.com/docs/msp-product-and-attribute-values
    - `attrs` FeatureAttributeForV3[] — - Attributes to be enabled for tenant. - Attrs can be empty. Example - [] - For valid products and their values, see - https://developer.druva.com/docs/msp-product-and-attribute-values
      - `name` string — Specify the name of the attribute. Example - 'userCount', 'preservedUserCount'
      - `value` object — Specify the value of the attribute. Example - 100

## Response `200`

Ok

- TaskCreatedResponse
  - `task` object
    - `id` string — The task ID of the operation, and can be used to track the progress. Use this task ID in the 'Get Task Details' API to track the operation's progress. Example - 'c8b54819-486a-497a-b86e-5b93f2422711'.

## Other responses

- `400` — Bad Request
- `422` — Unprocessable Entity
- `500` — The request was not processed due to an internal error in MSP Portal Service.

---

[API](https://skmtc.net/druva/apis/authentication.md) · [All operations](https://skmtc.net/druva/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/druva/authentication/revisions/2af2bf148b25/schema)