---
title: "Create a new CustomField"
method: POST
path: "/custom_fields.json"
tags: ["Custom Fields"]
---

# Create a new CustomField

`POST /custom_fields.json`

Outlines the parameters and data fields used when creating a new CustomField

## Query parameters

- `fields` string

## Headers

- `X-API-VERSION` string

## Request body

- object
  - `data` object, required
    - `display_order` integer — The display position of the CustomField.
    - `displayed` boolean — Whether or not the CustomField should be displayed by default.
    - `field_type` 'checkbox' | 'contact' | 'currency' | 'date' | 'time' | 'email' | 'matter' | 'numeric' | 'picklist' | 'text_area' | 'text_line' | 'url', required — Field type of the CustomField.
    - `name` string, required — CustomField name.
    - `parent_type` 'Contact' | 'Matter', required — Type of object the CustomField is for.
    - `picklist_options` object[]
      - `id` integer — The unique identifier for a single PicklistOption associated with the CustomField. The keyword `null` is not valid for this field. Not required for creating new PicklistOptions, but required for updating or deleting existing ones.
      - `option` string — The option value.
      - `_deleted` boolean — Whether or not the PicklistOption should be deleted.
    - `required` boolean — Whether or not the CustomField should require a value.

## Response `201`

Created

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too Many Requests

---

[API](https://skmtc.net/clio/apis/clio-api-documentation.md) · [All operations](https://skmtc.net/clio/apis/clio-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clio/clio-api-documentation/revisions/73791ddd1207/schema)