---
title: "Create Field in Project"
method: POST
path: "/projects/{project_id}/fields"
tags: ["Custom Fields"]
---

# Create Field in Project

`POST /projects/{project_id}/fields`

Create a new custom field on a project.

## Path parameters

- `project_id` string, required

## Request body

- FieldRequestCreateRequest
  - `name` string, required
  - `type` 'number' | 'text' | 'select' | 'date', required
  - `format` FieldFormat
    - `format` 'number' | 'currency' | 'percent' | 'label'
    - `type` 'date' | 'dob' — Optional type for date field
    - `decimals` number
    - `label` string — Label up to 8 symbols
    - `labelAt` 'left' | 'right' — Label position left/right
  - `icon` string
  - `options` FieldOption[] — Up to 10 options, required when `type` is `select`.
    - `id` number
    - `name` string
    - `color` string

## Response `200`

OK

- Field
  - `id` number — Custom field ID
  - `name` string
  - `type` string
  - `format` FieldFormat
    - `format` 'number' | 'currency' | 'percent' | 'label'
    - `type` 'date' | 'dob' — Optional type for date field
    - `decimals` number
    - `label` string — Label up to 8 symbols
    - `labelAt` 'left' | 'right' — Label position left/right
  - `options` FieldOption[]
    - `id` number
    - `name` string
    - `color` string
  - `position` number
  - `icon` string — Field icon name

## Other responses

- `401` — Unauthorized

---

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