---
title: "Create custom property value"
method: POST
path: "/v1/custom-properties/groups/{groupId}/values"
tags: ["v1 - Custom Properties"]
---

# Create custom property value

`POST /v1/custom-properties/groups/{groupId}/values`

## Request

- Base URL: `https://light.inc` (the document declares no server; this is the origin it was published from)
- URL: `https://light.inc/v1/custom-properties/groups/{groupId}/values`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

Creates a new custom property value in the specified group

## Path parameters

- `groupId` string, uuid, required

## Request body

- ExternalCreateCustomPropertyValueRequestV1Model
  - `internalName` string: Unique internal name for the custom property value.
  - `label` string: Display label for the custom property value.
  - `context` string, nullable: Optional context or description for the custom property value.

## Response `default`

default response

- ExternalCustomPropertyValueV1Model: List of values. Note that this will be a single value unless the group input type supports multiple values
  - `id` string, uuid: Unique identifier for the object
  - `groupId` string, uuid: ID of the custom property group
  - `groupInternalName` string: Internal name of the custom property group
  - `companyId` string, uuid: ID of the company
  - `internalName` string: Internal name of the custom property value
  - `label` string: Label of the custom property value
  - `context` string, nullable: Context/description of the custom property value
  - `createdAt` string, date-time: Timestamp when the custom property value was created
  - `updatedAt` string, date-time: Timestamp when the custom property value was last updated

---

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