> ## Documentation Index
> Fetch the complete documentation index at: https://guide.rolodexcrm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Custom Field

## `POST` a Custom Field

`POST` `/user-api/v1/custom-fields`

### Headers

| **Header**          | **Value**           |
| ------------------- | ------------------- |
| `Content-Type`      | `application/json`  |
| `x-rolodex-api-key` | `f1e2d3c4b5a697...` |

### Required Fields

<ParamField path="name" type="string">
  Field name (1-50 characters)
</ParamField>

<ParamField path="field_type" type="string">
  Field type: `SINGLE_LINE_TEXT`, `USER`, `SINGLE_SELECT`, `MULTI_SELECT`, `DATE`, `NUMERIC`, `BOOLEAN`
</ParamField>

<ParamField path="entity_type" type="string">
  Entity type: `CONTACT`, `COMPANY`
</ParamField>

### Optional Fields

<ParamField path="multi_select_options" type="array">
  Options for `SINGLE_SELECT` and `MULTI_SELECT` field types (1-50 characters each)
</ParamField>

### Request (Text Field)

```json theme={null}
{
  "name": "Department",
  "field_type": "SINGLE_LINE_TEXT",
  "entity_type": "CONTACT"
}
```

### Request (Single Select Field)

```json theme={null}
{
  "name": "Priority Level",
  "field_type": "SINGLE_SELECT",
  "entity_type": "CONTACT",
  "multi_select_options": [
    "High",
    "Medium",
    "Low",
    {
      "value": "Critical"
    }
  ]
}
```

### Request (Multi Select Field)

```json theme={null}
{
  "name": "Technologies",
  "field_type": "MULTI_SELECT",
  "entity_type": "COMPANY",
  "multi_select_options": [
    "JavaScript",
    "Python",
    "React",
    "Node.js",
    {
      "value": "TypeScript"
    }
  ]
}
```

### Response (Single Select Field)

```json theme={null}
{
  "data": {
    "id": "field_99999",
    "name": "Priority Level",
    "field_type": "SINGLE_SELECT",
    "entity_type": "CONTACT",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z",
    "multi_select_options": [
      {
        "id": "option_301",
        "value": "Critical"
      },
      {
        "id": "option_302",
        "value": "High"
      },
      {
        "id": "option_303",
        "value": "Low"
      },
      {
        "id": "option_304",
        "value": "Medium"
      }
    ]
  }
}
```

### Response (Text Field)

```json theme={null}
{
  "data": {
    "id": "field_88888",
    "name": "Department",
    "field_type": "SINGLE_LINE_TEXT",
    "entity_type": "CONTACT",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z"
  }
}
```

## Field Types

| **Type**           | **Description**               | **Example Usage**          |
| :----------------- | :---------------------------- | :------------------------- |
| `SINGLE_LINE_TEXT` | Single line text input        | Department, Job Title      |
| `USER`             | Reference to workspace user   | Account Manager, Sales Rep |
| `SINGLE_SELECT`    | Single choice from options    | Priority Level, Status     |
| `MULTI_SELECT`     | Multiple choices from options | Skills, Technologies       |
| `DATE`             | Date picker                   | Start Date, Follow-up Date |
| `NUMERIC`          | Number input                  | Lead Score, Revenue        |
| `BOOLEAN`          | True/false checkbox           | Is VIP, Active Status      |

## Entity Types

| **Type**  | **Description**                           |
| :-------- | :---------------------------------------- |
| `CONTACT` | Custom fields for contacts/people         |
| `COMPANY` | Custom fields for companies/organizations |