---
title: "Creating a new Custom Field Set"
method: POST
path: "/custom_field_sets"
tags: ["Custom Field Sets"]
---

# Creating a new Custom Field Set

`POST /custom_field_sets`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/custom_field_sets`
- Auth: none declared

To create a custom field, the current user must be the Account Administrator.

This endpoint returns structured Custom Field Set objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `custom_field_sets` top-level JSON key.
Please see our [Response Format](#section/Response-Format) section for more information.

## Query parameters

- `include` string

## Request body

- object
  - `custom_field_set` object
    - `name` string, required: The name of the custom field set.
    - `subject_type` string, required: The type of objects contained by the custom field set. The supported subjects are currently Workspace, Story, User, and WorkspaceGroup.

## Response `200`

Custom Field Set has been created.

- object
  - `count` integer
  - `meta` object
    - `count` integer
    - `page_count` integer
    - `page_number` integer
    - `page_size` integer
  - `results` object[]
    - `key` string
    - `id` string
  - `custom_field_sets` object
  - `external_references` object
  - `custom_fields` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)