---
title: "Create a new Enterprise Policy"
method: POST
path: "/enterprise/{enterprise_id}/policy/"
tags: ["esper_cloud_api_Enterprise Policy"]
---

# Create a new Enterprise Policy

`POST /enterprise/{enterprise_id}/policy/`

API to create a new Enterprise Policy

## Path parameters

- `enterprise_id` string, uuid, required

## Response `201`

command request successfully created

- EsperCloudApiEnterprisePolicy
  - `uuid` string, uuid — Unique Policy identifier
  - `enterprise` string, url, required — Url of the enterprise resource
  - `url` string, url — URL link to policy
  - `name` string, required — Name of the Policy
  - `description` string — Details regarding the Policy
  - `device_count` integer — Count of Devices with this policy applied
  - `google_policy_id` string — Id of the Google policy
  - `policy` EsperCloudApiEnterprisePolicyData, required
    - `keyguardDisabled` boolean — Should KeyGuard be disabled?
    - `safeBootDisabled` boolean — Should SafeBoot be disabled?
    - `statusBarDisabled` boolean — Should Status Bar be disabled?
    - `factoryResetDisabled` boolean — Should Factory Reset be disabled?
    - `screenshotDisabled` boolean — Should Screenshot capability be disabled?
    - `usbConnectivityDisabled` boolean — Should USB connectivity be disabled?
    - `smsDisabled` boolean — Should SMS functionality be disabled?
    - `outgoingCallsDisabled` boolean — Should Outgoing Calls be disabled?
    - `cameraDisabled` boolean — Should Camera be disabled?
    - `nfcBeamDisabled` boolean — Should NFC capability be disabled?
    - `disablePlayStore` boolean — Should Google Play Store be disabled on the device?
    - `usbFileTransferDisabled` boolean — Should USB File transfer capability be disabled?
    - `tetheringDisabled` boolean — Should USB Tethering capability be enabled?
    - `dateTimeConfigDisabled` boolean — Should Date/Time configuration capability be disabled?
    - `appUninstallDisabled` boolean — Should App uninstall capability be disabled?
    - `googleAssistantDisabled` boolean — Should Google Assistant feature be disabled?
    - `disableLocalAppInstall` boolean — Should Side-loading of Applications be disabled?
    - `adbDisabled` boolean — Should Android Debugger be disabled?
    - `phonePolicy` object — Rules regarding restricting calls from/to phone-numbers
      - `incomingNumbers` string[] — List of permitted incoming phone numbers to recieve calls from
      - `outgoingNumbers` string[] — List of permitted outgoing phone numbers to make calls to
      - `dialer` 'DEFAULT' | 'SHOONYA' — Pick a dialer - System default or Esper Dialer
      - `allowUssdCodes` boolean — Allow USSD codes to be dialed. Default is false
    - `frpGoogles` object[] — Details regarding Factory Reset Protection capability. List of permitted Google People IDs, emails and such
      - `type` 'USER' | 'ADMIN' — Type of User account provided - USER or ADMIN
      - `email` string, email — Email id to be used for Factory protection. This will be asked on the Device's UI
      - `googleId` string — Google People ID associated with the above email (https://developers.google.com/people/api/rest/v1/people/get)
    - `googleAccountPermission` object — Details regarding Google accounts to be associated with the device
      - `maxAccount` integer — Maximum number of Google accounts to be associated with this device. (Max = 10)
      - `emails` string[] — List of emails to be associated
      - `domains` string[] — List of domains that can be associated
    - `devicePasswordPolicy` object — Define the Password Policy for the device
      - `passwordQuality` 'PASSWORD_QUALITY_ALPHABETIC' | 'PASSWORD_QUALITY_ALPHANUMERIC' | 'PASSWORD_QUALITY_BIOMETRIC_WEAK' | 'PASSWORD_QUALITY_COMPLEX' | 'PASSWORD_QUALITY_NUMERIC' | 'PASSWORD_QUALITY_NUMERIC_COMPLEX' | 'PASSWORD_QUALITY_SOMETHING' | 'PASSWORD_QUALITY_UNSPECIFIED' — What is the type of password quality to apply to the device?
    - `minimumPasswordLength` integer — What is the minimum length for your device's password
    - `permissionPolicy` 'PERMISSION_POLICY_PROMPT' | 'PERMISSION_POLICY_AUTO_GRANT' | 'PERMISSION_POLICY_AUTO_DENY' — What permission should be applied by default for all apps, henceforth?
    - `deviceUpdatePolicy` object — Configuration regarding Device OS Updates
      - `type` 'TYPE_INSTALL_AUTOMATIC' | 'TYPE_POSTPONE' | 'TYPE_INSTALL_WINDOWED' | 'TYPE_INSTALL_DISABLED' — What type of installation is preferred?
      - `maintenanceStart` integer — If the `type` is `TYPE_INSTALL_WINDOWED`, when should the maintenance start?
      - `maintenanceEnd` integer — If the `type` is `TYPE_INSTALL_WINDOWED`, when should the maintenance end?
    - `settingsAccessLevel` 'SYSTEM' | 'SHOONYA' | 'NONE' — Type of Android settings app to be applied? Default System Settings or ESPER Settings App?
    - `settingsAppPassword` string, password — Lock Password (optional) for the ESPER Settings app
  - `updated_on` string, date-time — Last-Updated Timestamp of Policy
  - `created_on` string, date-time — Creation Timestamp of Policy
  - `is_active` boolean — Is this policy currently active

## Other responses

- `400` — Bad request
- `401` — Authorization information is missing or invalid.
- `403` — Forbidden, no permission to perform this action.
- `500` — Internal server error

---

[API](https://skmtc.net/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.net/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/esper/esper-api-reference/versions/e1f64cbb488e/schema)