---
title: "POST Custom Fields"
method: POST
path: "/customfields"
---

# POST Custom Fields

`POST /customfields`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/customfields`
- Auth: API key in query parameter `access_token`

/customfields
Permission level: 3

## Request body `application/x-www-form-urlencoded`

- object
  - `name` string, required
  - `type` string, required: enum[short, long, option, checkbox] "short" : Short Text - max 200 chars, "long": Long Text, "option": Option list (Select box), "checkbox": Checkbox
  - `access` integer: enum[1,2,3] 1 : Employee and Management, 2 : Employee Only, 3 : Management Only
  - `values` string: Values for option list separated by comma

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` integer
    - `name` string
    - `type` string
    - `access` integer
    - `values` string
  - `token` string
  - `error` unknown

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/customfields/post.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
