---
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`

## Request

- Base URL: `https://api.smartrecruiters.com`
- URL: `https://api.smartrecruiters.com/configuration/job-properties/{id}/values`
- Auth: one of:
  - API key in header `x-smarttoken`
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `configuration_manage`

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.dev/smartrecruiters/apis/configuration-api.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/configuration-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/configuration-api/revisions/65491281a1a6?raw)