---
title: "Create an administrator"
method: POST
path: "/console/v1/admins"
tags: ["Administrators"]
---

# Create an administrator

`POST /console/v1/admins`

## Request

- Base URL: `https://apis.druva.com/platform`
- URL: `https://apis.druva.com/platform/console/v1/admins`
- Auth: API key in header `Authorization`

Creates an administrator in the Druva Console.
 > 📘 **Note** 
 To use this API endpoint, enable the [Administrator API from Druva Cloud settings](/reference/administrators).

## Headers

- `Content-Type` 'application/json', required

## Request body

- V1AdminsBody
  - `adminEmail` string, required: The email address of the administrator you want to create.
  - `adminName` string, required: The name of the administrator you want to create.
  - `role` 'Product' | 'Druva Cloud', required: Select the role of the administrator. - Druva Cloud - Druva Cloud Administrator is a super administrator who gets all the rights of all the administrative roles across products, based on the services enabled for your account and the privileges needed to modify account settings. - Product - Product administrator can perform all core product-related activities such as configuring, managing, and monitoring.
  - `timezone` string, required: Specify the timezone of the administrator.
  - `productAccessControls` Consolev1adminsProductAccessControls: Specify this if you are creating a 'Product' administrator.
    - `products` Consolev1adminsProductAccessControlsProducts[]
      - `productID` integer: Possible values are 8193 - Insync, 12289 - Enterprise Workloads
      - `productRole` string: The role of the administrator you want to create. Administrator role types are available in the Cloud Console. ``` Possible Enterprise Workloads roles are : - Cloud Administrator - Cloud Administrator (View-only) - Data Protection Officer - Organization Administrator - Organization Administrator (View-only) - Group Administrator - Group Administrator (View-only) Possible inSync roles are : - Cloud Admin - Data Protection Officer - Help Desk Admin - Legal Admin - Profile Admin - Sensitive Data Governance Admin - View Only Admin - Workload Admin ``` :fa-info-circle: You can also assign any custom role that is created in the product console.
      - `accessControls` Consolev1adminsProductAccessControlsAccessControls[]: A list containing data about the sites and groups to which admin needs to be granted access
        - `collectionName` string: The name of the site/organization or Workloads/Profiles/Legal Hold Types for which you want to allow admin to access
        - `collectionID` integer: The id of the site/organization or Workloads/Profiles/Legal Hold Types for which you want to allow admin to access
        - `resource` string: Resource can be Organization / Groups or Workloads/Profiles/Legal Hold Types
        - `itemList` Consolev1adminsProductAccessControlsItemList[]: Details of group of which admin access is provided
          - `itemID` integer: Group id of the site the admin should be granted access
          - `itemName` string: Group name of the site the admin should be granted access
  - `provisioningMode` 'Manual' | 'AD_LDAP', required: The mode through which the admin is being created.
  - `adminState` 'ACTIVE' | 'DISABLED': The state of the admin to be created.
  - `adGuid` string: The globally unique identifier
  - `adMappingId` integer: The unique AD Mapping ID.
  - `adMappingName` string: The AD Mapping name.
  - `druvaDomainLegalConsent` boolean: Setting this parameter to True indicates you consent to creating a Druva administrator account with an email address ending in druva.com or druva.org.

## Response `200`

Success

- CreateAdminResponse
  - `globalCustomerId` string: The unique ID associated with the customer
  - `globalAdminId` string: The unique ID associated with the admin
  - `adminEmail` string: The email associated with the admin
  - `adminName` string: The name of the admin
  - `role` string: The role of the admin
  - `provisioningMode` string: The mode through which the admin was created
  - `adminState` string: The state of the created admin
  - `adGuid` string: The globally unique identifier
  - `disabledThroughMode` string: The mode through which the admin was disabled(Applicable only if the Admin is in DISABLED state)
  - `deletionEpoch` number, float: The deletion epoch in case the admin is marked for deletion
  - `deletionTime` string, date-time: The deletion time in case the admin is marked for deletion. The time is in the UTC time zone. Example - 2024-01-04T09:06:02.191Z

## Other responses

- `400`: Bad Request
- `404`: The requested resource was not found.
- `500`: The request was not processed due to an internal error.

---

[API](https://skmtc.dev/druva/apis/platform.md) - [All operations](https://skmtc.dev/druva/apis/platform/llms.txt) - [OpenAPI document](https://skmtc.dev/druva/apis/platform/revisions/80533a559af4?raw)