---
title: "Create a new Custom Fields Group"
method: POST
path: "/v2/customfieldsgroups"
tags: ["Custom Fields Groups"]
---

# Create a new Custom Fields Group

`POST /v2/customfieldsgroups`

Creates a new Custom Fields Group and returns the created Custom Fields Group.

## Headers

- `Authorization` string, required

## Request body

- CreateCustomFieldsGroupV2Dto
  - `entityType` 'JOB' | 'CLIENT', required — The entity type of the custom fields group.
  - `name` string, required — The custom fields group name.

## Response `201`

The created Custom Fields Group.

- ResponseCustomFieldsGroupV2Dto
  - `id` string — The ID of the custom fields group (prefix `CFG-`).
  - `entityType` 'JOB' | 'CLIENT' — The entity type of the custom fields group.
  - `name` string — The name of the custom fields group.

## Other responses

- `400` — Invalid input (e.g. a group with the same name already exists).
- `401` — Missing or invalid authentication token.

---

[API](https://skmtc.net/workiz/apis/developer-api.md) · [All operations](https://skmtc.net/workiz/apis/developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/workiz/developer-api/revisions/14666f4db0f8/schema)