---
title: "Create a new customer"
method: POST
path: "/msp/v3/customers"
tags: ["Customers"]
---

# Create a new customer

`POST /msp/v3/customers`

- The API supports the creation of Druva Provisioned customers.
- If no attributes are specified, an MSC Provisioned managed customer is created by default.
- The only supported attributes are licenseManagedAllowed and dataAccessAllowed. Providing any other attributes will result in an error.
- For dataAccessAllowed, the only supported value is 1 (Managed).
- This is an asynchronous operation. Upon initiation, a taskID is generated and can be retrieved from the success response. Use this taskID with the 'Get Task Details' API to track the progress of the operation.

## Headers

- `Authorization` string, required

## Request body

- CreateCustomerV3Request — Specify the details for a new customer.
  - `accountName` string, required — Specify the account name for the customer. Account name cannot be changed after creation. Example - 'Druva'
  - `address` string, required — Specify the address for the customer. Example - '213 Derrick Street Boston, MA 02130 USA'
  - `customerName` string, required — Specify the organization name for the customer. It should be unique across all customers of Druva. Example - 'Druva'
  - `phone` string, required — - Specify the phone number for the customer. Example - '12345678910' - Maximum length can be 30. - The country code must be prefixed with a '+' sign.
  - `tenantAdmins` integer[] — Specify the IDs of tenant admins assigned to the customers. You can get tenant admin IDs using 'List admins' API. Example - [1]
  - `features` object[] — Specify the features supported at Druva MSP customer level.
  - `attributes` CustomerAttributes[] — Specify the attributes supported at Druva MSP customer level.
    - `name` string, required — - The name of the customer attribute - For valid attributes and their values, see - https://developer.druva.com/docs/msp-product-and-attribute-values
    - `value` string, required — - The value of the customer attribute - For valid attributes and their values, see - https://developer.druva.com/docs/msp-product-and-attribute-values

## 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
- `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)