---
title: "Create a Credential Distribution Group"
method: POST
path: "/credential-distribution-groups"
tags: ["Administration"]
---

# Create a Credential Distribution Group

`POST /credential-distribution-groups`

Create a new Credential Distribution Group

## Request body

- XiqCredentialDistributionGroupCreateRequest
  - `name` string, required — Name of the credential distribution group.
  - `enable_email_approval` boolean, required — Flag indicating whether email approval is enabled (true) or disabled (false).
  - `enable_user_limitation` boolean, required — Flag indicating whether user limitation is enabled (true) or disabled (false).
  - `employee_group_type` 'ADMIN' | 'AD' | 'MANAGE', required — Employee Group Json Type
  - `employee_groups` XiqEmployeeGroup[] — Array of member groups.
    - `name` string — The employee group name
  - `restrict_number` integer — Number restriction.
  - `user_group_ids` integer[] — Array of user group IDs.

## Response `201`

Created

- XiqCredentialDistributionGroup — The Credential Distribution Group
  - `id` integer, required — The unique identifier
  - `create_time` string, date-time, required — The create time in UTC (ISO 8601 format)
  - `update_time` string, date-time, required — The last update time in UTC (ISO 8601 format)
  - `org_id` integer — The organization identifier, valid when enabling HIQ feature
  - `owner_id` integer — The owner ID of the Credential Distribution group
  - `group_type` string — The Group type
  - `enable_email_approval` boolean — Whether email approval is enabled
  - `enable_user_limitation` boolean — Whether user limitation is enabled
  - `employee_group_type` 'ADMIN' | 'AD' | 'MANAGE' — Employee Group Json Type
  - `employee_groups` XiqEmployeeGroup[] — The member employee groups
    - `name` string — The employee group name
  - `name` string — The name of the credential distribution group
  - `restrict_number` string — Restriction on number of credentials per employee
  - `user_groups` XiqCdgUserGroups[] — The UserGroups
    - `id` integer, required — The unique identifier
    - `create_time` string, date-time, required — The create time in UTC (ISO 8601 format)
    - `update_time` string, date-time, required — The last update time in UTC (ISO 8601 format)
    - `org_id` integer — The organization identifier, valid when enabling HIQ feature
    - `owner_id` integer — The owner ID
    - `name` string — The User Group Name
    - `json_type` string — JSON Type
    - `description` string — The user group description
    - `password_rule_settings_id` integer — The password rule settings id
    - `delivery_policy_settings_id` integer — The delivery policy settings id
    - `time_expiration_settings_id` integer — The time expiration settings id
    - `user_count` integer — The user count
    - `ssids` string[] — The list of SSIDs
    - `group_type` string — The user group type
    - `pcg_use_only` boolean — Whether PCG use only is enabled
    - `ppsk_use_only` boolean — Whether PPSK use only is enabled
    - `enable_pcg_filter` boolean — Whether PCG filter is enabled
    - `enable_self_reg` boolean — Whether self reg is enabled
    - `enable_renew` boolean — Whether renew is enabled

---

[API](https://skmtc.net/extremecloudiq/apis/extremecloud-iq-api.md) · [All operations](https://skmtc.net/extremecloudiq/apis/extremecloud-iq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/extremecloudiq/extremecloud-iq-api/versions/5ff7ab84e8e8/schema)