---
title: "Create new set or list"
method: POST
path: "/createSet"
tags: ["Sets"]
---

# Create new set or list

`POST /createSet`

This endpoint allows the creation of a new set or list, with its properties and collection of fields.

## Request body

- object
  - `name` string, required — Name of the set or list
  - `type` 'set' | 'list', required — Type of the set, either 'set' or 'list'.
  - `groupId` integer — Group ID, required if type is 'set', should be omitted if the type is 'list'.
  - `fields` object[], required — Collection of fields that will be added to the set. They will appear as form fields.
    - `label` string, required — Human-readable title for the field.
    - `abbreviation` string — Abbreviation for the field title.
    - `unit` string — Unit of measure for the field.
    - `method` string — The field's test method.
    - `type` 'date' | 'text' | 'numeric' | 'select' | 'check' | 'signature', required — Type of field.
    - `required` boolean — Indicates if the field is required.
    - `lockOnValue` boolean — Whether the field is locked after receiving its first value.
    - `isIndex` boolean — Indicates whether the field should be configured as the index field. Applies to required select fields only.
    - `format` 'date' | 'datetime' | 'integer' | 'decimal' | 'scientific' — Specific format for date or numeric fields. This property is required for date or numeric fields.
    - `multiLine` boolean — Controls the appearance of text fields in forms. Applies to text fields only.
    - `decimals` integer — Number of decimal places. Applies to numeric fields only.
    - `default` number — Default value for the field. Applies to numeric fields only.
    - `listId` integer — ID of the selection list associated with a select field. Applies to select fields only.
    - `listField` string — Field name in the selection list identified by `listId`. The referenced fields needs to be required and of type text or numeric
    - `radioButtons` boolean — Controls appearance of select fields, either radio buttons or dropdown. Applies to select fields only.
    - `lockResultSignoff` boolean — Whether the entire result should be locked upon sign-off. Applies to signature fields only.

## Response `200`

Set created successfully.

- object
  - `setId` integer — ID of the created set.

## Other responses

- `400` — Invalid request.
- `401` — Unauthorized. The caller does not have permission to create sets.

---

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