---
title: "/custom_fields/candidates/:id/fields"
method: POST
path: "/c/{company_id}/custom_fields/candidates/{id}/fields"
---

# /custom_fields/candidates/:id/fields

`POST /c/{company_id}/custom_fields/candidates/{id}/fields`

## Request

- Base URL: `https://api.recruitee.com`
- URL: `https://api.recruitee.com/c/{company_id}/custom_fields/candidates/{id}/fields`
- Auth: OAuth 2

Allows to add profile fields to a candidate with provided ID.

## Path parameters

- `company_id` string, required
- `id` string, required

## Headers

- `Content-Type` string

## Request body

- object
  - `field` object
    - `name` string: Profile field name
    - `values` object[]: Profile field values
      - `text` string
      - `flag` string
      - `value` string
      - `date` string
      - `country_code` string
      - `language_code` string
      - `level` string
    - `kind` string: Input type. Possible values: single_line, multi_line, boolean, address, gender, date_of_birth, nationality, language_skill, skills

## Response `200`

200

- object
  - `field` object
    - `fixed` unknown
    - `id` integer
    - `kind` string
    - `name` string
    - `origin` string
    - `values` object[]
      - `text` string
    - `visibility` object
      - `admin_ids` unknown[]
        - unknown
      - `level` string
      - `role_ids` unknown[]
        - unknown
    - `visible` boolean

## Other responses

- `422`: 422

---

[API](https://skmtc.dev/recruitee/apis/ats-api.md) - [All operations](https://skmtc.dev/recruitee/apis/ats-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recruitee/apis/ats-api/revisions/92a80d21a7e0?raw)