---
title: "Create a new field."
method: POST
path: "/company/people/fields"
tags: ["Metadata"]
---

# Create a new field.

`POST /company/people/fields`

## Request body

- CreateFieldRequest
  - `name` string, required — The name of the field.
  - `category` string, required — The category of the field.
  - `type` string, required — The type of field. Supported field types: text, text-area, number, date, list, multi-list, hierarchy-list, currency, employee-reference, document.
  - `description` string — The description of the field.
  - `historical` boolean — When true, this field keeps the history of its values, each being active starting from a certain date. The default value is false.

## Response `200`

The new field was successfully created. The ID of the field is returned.

- FieldId — Field ID structure for field updates
  - `id` string, required — The field path (e.g., /position/status)

## Other responses

- `400` — If the category of the field is root, or historical is set to true, but the category doesn't allow it, or if the field type is not supported.
- `404` — If the category of the field doesn't exist

---

[API](https://skmtc.net/hibob/apis/employee-data-api.md) · [All operations](https://skmtc.net/hibob/apis/employee-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hibob/employee-data-api/versions/0781ebbdda91/schema)