---
title: "Create a new group"
method: POST
path: "/groups"
tags: ["Groups"]
---

# Create a new group

`POST /groups`

Creates a new group. Provide the necessary details as per the group type.

## Request body

- GroupProperties
  - `name` string, required — The group's name.
  - `type` 'general' | 'administrators' | 'end-users', required — The group type.
  - `supportLevel` integer — A number representing the support level (from existing support levels).
  - `companyId` integer, nullable — The unique identifier for the company associated with the group.
  - `email` string, email — The email address associated with the group.
  - `receiveAutomaticSrEmailNotifications` boolean — Indicates whether the group receives automatic SR email notifications.
  - `canBeAssignedToServiceRecord` boolean — Indicates if the group can be assigned to a service record. Not applicable if `type` is set to `END_USERS`.
  - `enableAutomaticDispatchOfServiceRecords` boolean — Determines if service records should be automatically dispatched. Only applicable if `canBeAssignedToServiceRecord` is `true`

## Response `201`

Group created successfully

- Group
  - `name` string, required — The group's name.
  - `type` 'general' | 'administrators' | 'end-users', required — The group type.
  - `supportLevel` integer — A number representing the support level (from existing support levels).
  - `companyId` integer, nullable — The unique identifier for the company associated with the group.
  - `email` string, email — The email address associated with the group.
  - `receiveAutomaticSrEmailNotifications` boolean — Indicates whether the group receives automatic SR email notifications.
  - `canBeAssignedToServiceRecord` boolean — Indicates if the group can be assigned to a service record. Not applicable if `type` is set to `END_USERS`.
  - `enableAutomaticDispatchOfServiceRecords` boolean — Determines if service records should be automatically dispatched. Only applicable if `canBeAssignedToServiceRecord` is `true`
  - `id` integer, required — The unique identifier of the group.

## Other responses

- `400` — The request was invalid or cannot be served
- `401` — Authentication information is missing or invalid
- `409` — The request could not be completed due to a conflict with the current state of the resource. This typically occurs when attempting to create a duplicate resource, update a resource that has been modified by another process, or when business rules prevent the operation.

---

[API](https://skmtc.net/sysaid/apis/sysaid-public-api.md) · [All operations](https://skmtc.net/sysaid/apis/sysaid-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sysaid/sysaid-public-api/revisions/38a43a1b2981/schema)