---
title: "Creates a Value"
method: POST
path: "/api/2026-07-01/resources/custom_fields/values"
tags: ["CustomFields > Value"]
---

# Creates a Value

`POST /api/2026-07-01/resources/custom_fields/values`

Creates a Value

## Request body

- object
  - `field_id` string, required — Custom Fields identifier
  - `valuable_type` string, required — Type of the object that the custom field is attached to: 'Document' | 'Employee' | 'Contracts::ContractVersion' | 'CustomResources::Value'
  - `valuable_id` string, required — Identifier of the object that the custom field is attached to
  - `value` string, required — Custom Fields value

## Response `201`

CREATED

- CustomFieldsValue
  - `id` string, required — Unique identifier for the custom field value
  - `value` string — Custom Fields value
  - `long_text_value` string — Custom field text value
  - `custom_field_identifier` string, required — The unique identifier of the custom field
  - `date_value` string — Custom field date value
  - `single_choice_value` string — Custom field single choice value
  - `cents_value` integer — Custom field number value
  - `valuable_id` string, required — The identifier of the object that owns this custom field value
  - `field_id` string, required — The identifier of the custom field
  - `valuable_type` string, required — The type of the object that owns this custom field value
  - `label` string — The label of the custom field
  - `required` boolean — Whether the custom field is required
  - `usage_group_id` string — The identifier of the usage group
  - `usage_group_slug` string — The slug of the usage group
  - `updated_at` string — The date and time the custom field value was last updated.

---

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