---
title: "Create a new job."
method: POST
path: "/api/external/job/create"
tags: ["Job APIs"]
---

# Create a new job.

`POST /api/external/job/create`

<br/><b>Please find the input format details below.</b><br/><li> about_position:<br/>     Job Description<br/></li><br/><br/><li> client_company_id:<br/>     Please refer to the list of clients in client list api in the doc.<br/></li><br/><br/><li> created_by:<br/>     Id of the user creating the job.<br/></li><br/><br/><li> department_id:<br/>     Find the list of department ids in Other APIS.<br/></li><br/><br/><li> employment_type_id:<br/>     Find the list of employment type ids in Other APIS.<br/></li><br/><br/><li> locations:<br/>     Array of location ids, get the list of locations from /api/external/location/list API.<br/></li><br/><br/><li> title:<br/>     Job title.<br/></li><br/><br/><b>Please find the format of custom field input below.</b><br/><li> Single select:<br/>{<br/> "id": single_select_cf_id,<br/> "value": choice id (get the list from candidate/custom-field/list)<br/>}<br/></li><br/><br/><li> Multi select :<br/>{<br/> "id": multi_select_cf_id,<br/> "value": [choice id1, choice id2] (get the list from candidate/custom-field/list)<br/>}<br/></li><br/><br/><li> Short/Long text:<br/>{<br/> "id": short_text_cf_id,<br/> "value": "text"<br/>}</li><br/><br/><li> Money:<br/>{<br/>  "id": money custom field id,<br/>  "value": {"number": Integer(The amount), "currency": "string(Currency code eg. USD, GBP)"}<br/>}<br/><br/><li> Money Range:<br/>{<br/>  "id": money reange custom field id,<br/>  "value": {"number1": Integer(Starting Amount), "number2": "Ending Amount", "currency": "string(Currency code eg. USD, GBP)"}<br/>}<br/><br/><li> Number/Date:<br/>{<br/> "id": cf_id,<br/> "value": number/date to store<br/>}<br/></li><br/><br/><li> Yes No:<br/>{<br/> "id": yes_no_cf_id,<br/> "value": 0 for No and 1 for Yes<br/>}</li><br/><br/><li> Parent-Child :<br/>{<br/> "id": parent-child-cf-id,<br/> "value": [{"name": "parent_name", "children": ["child1", "child2"]}]<br/>}</li><br/><br/><li> Profile:<br/>{<br/> "id": profile_cf_id,<br/> "value": [{"type": "candidate", "id": candidate_id}]<br/>}</li><br/><br/><li> Users:<br/>{<br/> "id": users_cf_id,<br/> "value": [integer_user_id_1, integer_user_id_1]<br/>}</li><br/><br/>

## Headers

- `RF-Api-Key` string
- `content-type` string

## Request body

- object
  - `about_position` string
  - `added_time` string
  - `client_company_id` integer — Please refer to the list of clients in client list api in the doc.
  - `contacts` integer[] — Find the list of contact ids in contact list API.
  - `created_by` integer — Id of the user creating the job.
  - `custom_fields` object[] — Please refer to doc above
    - `id` integer
    - `value` string
  - `department_id` integer — Find the list of department ids in Other APIS.
  - `employment_type_id` integer — Find the list of employment type ids in Other APIS.
  - `experience_range_end` integer
  - `experience_range_start` integer
  - `hiring_team` object[]
    - `id` integer
    - `values` object[]
      - `user_id` integer
  - `locations` integer[]
  - `number_of_openings` integer
  - `salary_range_end` number
  - `salary_range_start` number
  - `skills` string[]
  - `title` string

## Response `200`

Auto generated using Swagger Inspector

---

[API](https://skmtc.net/recruiterflow/apis/recruiterflow-api-documentation.md) · [All operations](https://skmtc.net/recruiterflow/apis/recruiterflow-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/recruiterflow/recruiterflow-api-documentation/versions/9e36b3759d5d/schema)