---
title: "Create object field"
method: POST
path: "/public/v1/objects/{name}/fields"
tags: ["Object fields"]
---

# Create object field

`POST /public/v1/objects/{name}/fields`

Creates a column on an object. Requires a USER API key with ADMIN or OWNER role.

## Path parameters

- `name` string, required

## Request body

- object
  - `name` string, required
  - `type` union, required
    - 'string' | 'number' | 'boolean' | 'date' | 'tags' | 'relation' | 'autoIncrement' | 'dateOnly' | 'prismaRelation' | 'kanbanViewOrder' | 'file' | 'avatar' | 'permissions' | 'formula'
    - 'select'
  - `metadata` object
  - `record_type_id` integer
  - `recordTypeId` integer

## Response `201`

Created field

- object
  - `ok` true, required
  - `data` object, required
    - `id` number, required
    - `name` string, required
    - `key` string, required
    - `type` string, required
    - `editable` boolean, required
    - `created_at` string, nullable, required
    - `updated_at` string, nullable, required
    - `read_only` boolean
    - `required` boolean
    - `unique` boolean
    - `is_system` boolean
    - `is_predefined` boolean
    - `default_value` object, nullable
    - `format` string
    - `mode` 'singleSelect' | 'multiSelect' | 'single' | 'multi'
    - `timezone` string
    - `decimals` number
    - `currency` string
    - `min` number, nullable
    - `max` number, nullable
    - `time_format` string
    - `show_preview` boolean
    - `allowed_file_types` string[]
    - `max_file_size` number
    - `related_table_id` number
    - `related_record_type_ids` number[], nullable
    - `display_field_id` number
    - `relation_mode` string
    - `include_activity` boolean
    - `metadata` object
    - `options` object[]
      - `id` number, required
      - `name` string, required
      - `color` string, required
      - `order` number, required
      - `created_at` string, nullable, required
      - `updated_at` string, nullable, required
    - `expression` object, nullable
    - `output_type` string
    - `apply_if` object, nullable
    - `number_config` object, nullable
    - `date_config` object, nullable
    - `string_config` object, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/getfrontline/apis/public-api.md) · [All operations](https://skmtc.net/getfrontline/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getfrontline/public-api/versions/9d33b6aad674/schema)