---
title: "Create Custom field"
method: POST
path: "/projects/{project_id}/custom_fields"
tags: ["project"]
---

# Create Custom field

`POST /projects/{project_id}/custom_fields`

## Request

- Base URL: `https://api.ora.pm`
- URL: `https://api.ora.pm/projects/{project_id}/custom_fields`
- Auth: OAuth 2
  - Authorization code: `https://app.ora.pm/authorize`
  - Token URL: `https://api.ora.pm/oauth/token` scopes: `read`, `write`

## Request body

- CreateCustomField
  - `name` string, required: Title of the custom field.
  - `description` string: Description about the custom field.
  - `type` integer: Type of the custom field (1 - Dropdown, 2 - Number, 3 - Text, 4 - Number, 5 - Date, 6 - Checkbox).
  - `options` object[]: List with the dropdown options. (It's returned if the type is 1).
  - `is_multiline` boolean: True if the textfield is multiline. (It's returned if the type is 3).
  - `number_format` integer: 1 - Number, 2 - USD, 3 - EUR, 4 - GBP, 5 - YEN, 6 - Percent, 7 - Custom, 8 - Unformatted (It's returned if the type is 3).
  - `position` integer: 0 - None, 1 - Left, 2 - Right (It's returned if the type is 2).
  - `label` string: Which label to show, Example: %, $. (It's returned if the type is 2).
  - `decimals` integer: (It's returned if the type is 2).

## Response `200`

OK

## Other responses

- `400`: Bad request
- `401`: Unauthorized

---

[API](https://skmtc.dev/ora/apis/ora-api.md) - [All operations](https://skmtc.dev/ora/apis/ora-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ora/apis/ora-api/revisions/983b9e0b0dda?raw)