---
title: "Create a job property"
method: POST
path: "/configuration/job-properties"
tags: ["configuration"]
---

# Create a job property

`POST /configuration/job-properties`

Creates a job property

## Request body

- JobPropertyDefinitionCreationRequest
  - `label` string, required
  - `category` 'job' | 'organization', required
  - `active` boolean
  - `visible` boolean, required
  - `required` boolean
  - `key` string

## Response `201`

Created job property

- JobPropertyDefinition
  - `id` string
  - `label` string, required
  - `category` 'job' | 'organization', required
  - `active` boolean
  - `visible` boolean, required
  - `required` boolean
  - `key` string
  - `actions` Actions

## Other responses

- `403` — Forbidden to access the resource, check your authorisation and rights.
- `409` — with code * **NON_UNIQUE_CUSTOM_FIELD_KEY** when job property key already exists
- `422` — With codes: * *JOB_PROPERTY_LIMIT_EXCEEDED* when job properties limit is reached, * *DEFINITION_NAME_IS_NOT_ALLOWED* when job property name is restricted.

---

[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/revisions/449bdc2516c9/schema)