---
title: "Create custom fields"
method: POST
path: "/v{version}/CustomFields"
tags: ["CustomFields"]
---

# Create custom fields

`POST /v{version}/CustomFields`

<h3>The list of Ids for the request body</h3>
<hr />
<table>
  <tr>
    <td>
      <b>Custom Field Types</b>
    </td>
    <td>
      <b>fieldTypeId</b>
    </td>
    <td>
      <b>Service Offerings</b>
    </td>
    <td>
      <b>serviceOfferingId</b>
    </td>
    <td>
      <b>Custom List Sort Types</b>
    </td>
    <td>
      <b>sortTypeId</b>
    </td>
    <td>
      <b>Free Form Data Types</b>
    </td>
    <td>
      <b>dataTypeId</b>
    </td>
  </tr>
  <tr>
    <td>Team Members</td>
    <td>1</td>
    <td>Contract Job</td>
    <td>1</td>
    <td>Alphabetically</td>
    <td>1</td>
    <td>Date</td>
    <td>1</td>
  </tr>
  <tr>
    <td>Custom List</td>
    <td>2</td>
    <td>Direct Hire Start</td>
    <td>2</td>
    <td>Manually</td>
    <td>2</td>
    <td>Number</td>
    <td>2</td>
  </tr>
  <tr>
    <td>Free Form</td>
    <td>3</td>
    <td>Team Profile</td>
    <td>6</td>
    <td></td>
    <td></td>
    <td>Textbox</td>
    <td>3</td>
  </tr>
  <tr>
    <td></td>
    <td></td>
    <td>Client Profile</td>
    <td>7</td>
    <td></td>
    <td></td>
    <td>Phone</td>
    <td>4</td>
  </tr>
  <tr>
    <td></td>
    <td></td>
    <td>Contractor Profile</td>
    <td>8</td>
    <td></td>
    <td></td>
    <td>Email</td>
    <td>5</td>
  </tr>
</table>

## Path parameters

- `version` string, required

## Headers

- `company-id` string, required

## Request body

- CompaniesContractsCommandsCreateCustomFieldsCommand
  - `companyId` string, uuid
  - `customFieldName` string, nullable
  - `fieldTypeId` integer
  - `isActive` boolean
  - `sortTypeId` integer, nullable
  - `dataTypeId` integer, nullable
  - `customFieldListItems` BilfloModelsCompanySettingsDTOsCustomFieldListItemCreate[], nullable
    - `customFieldName` string, nullable
    - `isActive` boolean
  - `customFieldLocations` BilfloModelsCompanySettingsDTOsTrackingCreate[], nullable
    - `serviceOfferingId` integer
    - `isRequired` boolean
    - `salesAndGrossProfitSplitPercentage` number, double, nullable

## Response `200`

Success

- CompaniesContractsCommandsCreateCustomFieldsResponse
  - `isValid` boolean
  - `errors` string[], nullable
  - `warnings` string[], nullable
  - `info` string[], nullable
  - `message` string, nullable
  - `data` CompaniesContractsCommandsCreatedCustomFieldsResponse
    - `customFieldId` integer

---

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