---
title: "Create a job property value"
method: POST
path: "/configuration/job-properties/{id}/values"
tags: ["configuration"]
---

# Create a job property value

`POST /configuration/job-properties/{id}/values`

Creates a job property value.

## Request body

- JobPropertyValueDefinition
  - `id` string
  - `label` string, required
  - `archived` boolean

## Response `201`

Created job property value

- JobPropertyValueDefinition
  - `id` string
  - `label` string, required
  - `archived` boolean

## Other responses

- `400` — when value is invalid with codes: * *VALUES_NOT_ALLOWED* when values are not allowed (e.g. for free text fields)
- `403` — Forbidden to access the resource, check your authorisation and rights.
- `404` — When job property not found.
- `409` — When job property value with given label already exists.
- `422` — when value id is invalid or with codes: * *ACTIVE_VALUES_LIMIT_REACHED* when limit of active job property values is reached * *VALUES_LIMIT_REACHED* when the limit of job property values (active and inactive) is reached * *VALUE_LABEL_IS_BLANK* when provided label is blank * *VALUE_LABEL_IS_INVALID* when provided label is not valid, e.g. contains leading/trailing whitespaces

---

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