---
title: "Create an enrollment group"
method: PUT
path: "/enrollmentGroups/{enrollmentGroupId}"
---

# Create an enrollment group

`PUT /enrollmentGroups/{enrollmentGroupId}`

Create an enrollment group.

## Path parameters

- `enrollmentGroupId` string, required

## Query parameters

- `api-version` string, required

## Request body

- EnrollmentGroup — The enrollment group definition.
  - `id` string — Unique ID of the enrollment group.
  - `displayName` string, required — Display name of the enrollment group.
  - `enabled` boolean — Whether the devices using the group are allowed to connect to IoT Central.
  - `type` 'iot' | 'iotEdge', required — Type of devices that connect through the group.
  - `attestation` GroupAttestation, required — The attestation definition for an enrollment group.
    - `type` string, required — Type of the attestation.
  - `etag` string — ETag used to prevent conflict in enrollment group updates.
  - `idScope` string — ID scope for connecting to the IoT Central application.

## Response `200`

Success

- EnrollmentGroup — The enrollment group definition.
  - `id` string — Unique ID of the enrollment group.
  - `displayName` string, required — Display name of the enrollment group.
  - `enabled` boolean — Whether the devices using the group are allowed to connect to IoT Central.
  - `type` 'iot' | 'iotEdge', required — Type of devices that connect through the group.
  - `attestation` GroupAttestation, required — The attestation definition for an enrollment group.
    - `type` string, required — Type of the attestation.
  - `etag` string — ETag used to prevent conflict in enrollment group updates.
  - `idScope` string — ID scope for connecting to the IoT Central application.

## Other responses

- `default` — An error response received from the IoT Central Service.

---

[API](https://skmtc.net/azure/apis/iotcentral-iotcentral.md) · [All operations](https://skmtc.net/azure/apis/iotcentral-iotcentral/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/iotcentral-iotcentral/versions/565d8813cbd3/schema)