---
title: "Create a candidate work history item"
method: POST
path: "/candidates/{id}/work_history"
tags: ["Candidates"]
---

# Create a candidate work history item

`POST /candidates/{id}/work_history`

## Path parameters

- `id` number, required

## Request body

- object
  - `title` string, required
  - `employer` object, required — An object containing the employer information for a work history item with one of the following structures: ``` { "linked": false, "name": "<employer name>", "location": { "city": "<employer city>", "state": "<employer state>" } } ``` or ``` { "linked": true, "company_id": 465 } ``` Both `linked` and `name` are required fields within the first object, and `linked` and `company_id` are required in the second object.
    - `linked` boolean
    - `name` string
    - `location` object
      - `city` string
      - `state` string
  - `supervisor` object — An object containing the supervisor information for a work history item with one of the following structures: ``` { "linked": false, "name": "<supervisor name>", "phone": "<supervisor phone number>" } ``` or ``` { "linked": true, "contact_id": 6864 } ```
    - `linked` boolean
    - `name` string
    - `phone` string
  - `is_verified` boolean
  - `is_current` string — If this is set to `true`, both `end_date` and `reason_for_leaving` will be ignored.
  - `start_date` string
  - `end_date` string
  - `reason_for_leaving` string

## Response `201`

Created

---

[API](https://skmtc.net/catsone/apis/cats-api-v3.md) · [All operations](https://skmtc.net/catsone/apis/cats-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/catsone/cats-api-v3/versions/dedbbade450d/schema)