TAB

to ask AI

curl -X POST "https://api.corma.io/v1/custom-fields" \ -H "x-corma-api-key: $CORMA_OPEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "key": "string", "label": "string", "type": "text" }'

API referenceCustom fields

Create custom field

Define a custom field in the company workspace. The key is unique in the workspace and is the key of the field in the customFields object of a user.

POST

/v1/custom-fields

POST

/custom-fields

curl -X POST "https://api.corma.io/v1/custom-fields" \
  -H "x-corma-api-key: $CORMA_OPEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "key": "string",
  "label": "string",
  "type": "text"
}'

Authorization

x-corma-api-key
string
header
required
Colon-separated API key ID and secret: API_KEY_ID:API_KEY_SECRET

Parameters

x-corma-idempotency-key
string
header
Optional client-generated key. Reusing the same key with an identical request replays the original response instead of enqueueing a duplicate task.

Body

application/json

key
string
required
label
string
required
type
enum<string>
required
One of:
text
number
boolean
date
user
entity
enum<string>
One of:
user
Default:
user

Response

application/json201

key
string
required
label
string
required
type
enum<string>
required
One of:
text
number
boolean
date
user
entity
enum<string>
required
One of:
user
createdAt
string<date-time>
required
The timestamp of when this resource was created. ISO 8601 format.
updatedAt
string<date-time>
required
The timestamp of the last update to this resource. ISO 8601 format.

{
  "key": "string",
  "label": "string",
  "type": "text",
  "entity": "user",
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}