Create field

POST/v1/custom-fields

Define a custom field.

Scope crm:adminIdempotency-Key optional

Request body

field_idstringRequired
labelstringRequired: 1 to 60 characters
typeenumRequired: One of text, number, date, single_select
optionsarray of string: Up to 100 items
positioninteger

Response

201Success

Response fields

field_idstringRequired
labelstringRequired
typestringRequired
optionsarray of stringRequired
positionintegerRequired
created_atstringRequired

Errors

401unauthorized. The key is missing, unknown or revoked
403insufficient_scope. The key lacks the scope above
403forbidden, or insufficient_scope
409field_exists, or idempotency_conflict
422validation_error

Every error has the same shape. See Errors.

1curl -X POST https://api.omnio.sawego.com/v1/custom-fields \
2  -H "Authorization: Bearer $OMNIO_API_KEY"
3  -H "Content-Type: application/json"
4  -d '{
5    "field_id": "plan",
6    "label": "Plan",
7    "type": "single_select",
8    "options": [
9      "silver",
10      "gold"
11    ]
12  }'

1{
2  "field_id": "plan",
3  "label": "Plan",
4  "type": "single_select",
5  "options": [
6    "silver",
7    "gold"
8  ]
9}

1{
2  "field_id": "plan",
3  "label": "Plan",
4  "type": "text",
5  "options": [
6    "option"
7  ],
8  "position": 0,
9  "created_at": "2026-10-05T14:02:11Z"
10}